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PREFACE 



This manual describes CONTROL DATA® Sort/Merge 
Version 5.0, a generalized sorting and merging 
utility. As described in this publication, Sort/ 
Merge Version 5.0 operates under control of the 
NOS 2 and the NOS/BE 1 operating systems for the 
CDC® CYBER 180 and CYBER 170 Computer Systems. 

This manual is written for the application program- 
mer. You are assumed to be familiar with the CDC 
operating system installed at your site and, if you 
are using procedure calls to Sort/Merge, with the 
calling language. 

You can find related information in the publica- 
tions listed below; the publications are listed 



within groupings that indicate relative importance 
to you. 

The NOS manual abstracts and the NOS/BE manual 
abstracts are pocket-sized manuals containing brief 
descriptions of the contents and intended audience 
of all NOS and NOS product set manuals and NOS/BE 
and NOS/BE product set manuals, respectively. The 
manual abstracts can be useful in determining which 
manuals are of greatest interest to you. The 
Software Publications Release History serves as a 
guide in determining which revision level of 
software documentation corresponds to the 
Programming System Report (PSR) level of software 
installed at your site. 



The following manuals are of primary interest: 



Publication 

COBOL Version 5 Reference Manual 

CYBER Record Manager 

Basic Access Methods Version 1.5 

Reference Manual 

FORTRAN Version 5 Reference Manual 

SORT/MERGE Version 5 Instant 



Publication 






Number 


NOS 2 


NOS/BE 1 


60497100 


X 


X 


60495700 


X 


X 


60481300 


X 


X 


60484900 


X 


X 



The following manuals are of secondary interest: 



Publication 

INTERCOM Version 5 Reference Manual 

Network Products 

Remote Batch Facility Version 1 

Reference Manual 

NOS Version 2 Manual Abstracts 

NOS Version 2 Reference Set, Volume 1 
Introduction to Interactive Usage 

NOS Version 2 Reference Set, Volume 3 
System Commands 

NOS/BE Version 1 Manual Abstracts 

NOS/BE Version 1 Reference Manual 

Software Publications Release History 



Publication 






Number 


NOS 2 


NOS/BE 1 


60455010 




X 


60499600 


X 




60485500 


X 




60459660 


X 




60459680 


X 




84000470 




X 


60493800 




X 


60481000 




X 



CDC manuals can be ordered from Control Data Corporation, Literature and 
Distribution Services, 308 North Dale Street, St. Paul, Minnesota 55103. 

This product is intended for use only as described in this 
document. Control Data cannot be responsible for the proper 
functioning of undescribed features or parameters. 
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NOTATIONS 



Unless otherwise specified, the conventions de- 
scribed in: the following paragraphs are used 
throughout this manual in parameter and procedure 
call formats, examples, and diagnostic messages. 

UPPERCASE Uppercase letters indicate words, 
acronyms, or mnemonics required as 
input by Sort/Merge or produced as 
output by Sort/Merge. Parameter 
keywords and interactive commands 
are included in this category. 

lowercase Lowercase letters indicate words 
or symbols that you must supply. 

... Ellipsis In a parameter or pro- 
cedure call format indicates that 
omitted portions of the format can 
be repeated. 



[ ] 






Brackets indicate an optional por- 
tion of a parameter or procedure 
call format. 



Two periods In a parameter format 
indicate a range of letters or 
digits . 



Delta indicates a space (blank). 



Boxes Indicate character positions 
in storage. 



Unless otherwise indicated, all numbers in text are 
decimal values. 
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GENERAL DESCRIPTION 



Sort/Merge Version 5 is a set of powerful and 
efficient routines that provides high-speed sorting 
or merging of records with a single control state- 
ment. This section introduces the features of 
Sort/Merge and provides you with an overview of the 
Sort/Merge relationship with system software. 



FUNCTIONS AND FEATURES 

The purpose of sorting is to arrange items in 
order; the purpose of merging is to combine two or 
more sets of preordered items. Using Sort/Merge, 
records are rearranged in the order you specify, or 
two or more sorted files are combined into one 
file. Sort/Merge offers the following features: 

• A sort or merge specification with a single 
control statement 

• An optional directive file for sort or merge 
specification 

• The capability of sorting or merging records 
from as many as 100 files with one call to 
Sort /Merge 

• Character and noncharacter sort key types 

• Five predefined collating sequences 

• User-defined collating sequences 

• Summing of numeric fields 

• Sorting of any CYBER Record Manager (CRM) 
sequential file and any record type (except U) 

• A tutorial dialog for interactive sort or merge 
specification 

• A set of procedures for sort or merge proc- 
essing from within a program written in FORTRAN 
or some other language 

• Interface with COBOL programs through a C0B0L5 
control statement option or direct calls 

• Owncode routines to insert, substitute, modify, 
or delete records during Sort/Merge processing 

These features are described briefly in the fol- 
lowing paragraphs. 

Sorts are initiated with the S0RT5 control state- 
ment; merges are Initiated with the MERGE control 
statement. You specify processing requirements for 
the sort or merge with parameters in the respective 
control statement. Merge processing requires files 
that have already been sorted. Sort/Merge gener- 
ates code based on the parameters and parameter 
values that you include in the S0RT5 or MERGE 
control statement. 



The SORTS or the MERGE control statement can be up 
to 240 characters in length. You can specify more 
complex sorts or merges by using a directive file 
for additional parameters. Sort/Merge reads the 
parameters in a directive file after all of the 
parameters in the control statement have been 
read. Using a single control statement to specify 
your sort or merge provides simplicity and elimi- 
nates the necessity of creating, saving, and 
subsequently retrieving directive files. Directive 
files, on the other hand, provide standardization 
of installation parameters and collating sequences. 

Records are sorted or merged on fields of data 
within each input record; the fields are called 
sort keys. Sort keys can be 6-bit character data, 
signed or unsigned binary integers, or floating- 
point numbers. Data can be sorted or merged 
according to a predefined or user-defined collating 
sequence for character data, or according to 
numeric value for numeric data. Numeric data can 
be signed or unsigned. 

Records with equal sort key fields can be combined 
into one new record. You can specify that numeric 
fields be added to the corresponding fields in the 
other records with equal keys. The one resultant 
record contains the key fields and the numeric 
fields that are the sums of the specified numeric 
fields in all the records with equal keys; data 
fields that are not key or sum fields are set to 
the corresponding fields in one of the old records. 

Sort/Merge uses CRM file processing and input/ 
output capabilities. Any of the CRM sequential 
files or record types (except U) can be sorted or 
merged; this includes both fixed and variable 
length records. Because Sort/Merge uses CRM, the 
characteristics of files input to Sort/Merge and 
files output from Sort/Merge must be described to 
CRM with FILE control statements unless default 
characteristics apply. 

You can specify any sort or merge from your termi- 
nal by entering the S0RT5 or MERGE control state- 
ment and processing parameters. An interactive 
dialog is also available to guide you, step by 
step, through your sort or merge specification. 
The processing options are presented, and you 
choose the option you want as well as identify your 
files and sort key fields to Sort/Merge. Several 
interactive commands are available to control the 
use of the interactive dialog. During the dialog, 
you can obtain an explanation of Sort /Merge usage 
by entering HELP at your terminal. 

A set of procedures exists that allows you to 
initiate a sort or merge from within your program 
written in FORTRAN or some other lanquage. The 
same processing options are available using calls 
to the procedures as are available using the SORTS 
or the MERGE control statement; the procedure calls 
closely correspond to the Sort/Merge parameters. 
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A C0B0L5 control statement option exists that 
allows you to use Sort/Merge 5. If you specify 
S0RT5 in your C0B0L5 control statement, Sort/ 
Merge 5 Is used when the COBOL SORT or MERGE state- 
ment in your program executes. 

You can write routines, called owncode routines, to 
insert, substitute, modify, or delete records 
during Sort/Merge processing. Owncode routines are 
subroutines written in FORTRAN or some other 
language. The routines must be complied; the file 
containing the compiled routines is loaded during 
your sort or merge. Depending on the exit number 
you specify, owncode routines are executed to 
process input records, output records, or records 
with equal keys. You can use owncode routines with 
control statement sorts or merges, or with proce- 
dure calls to Sort/Merge. 



CONFIGURATION AND SOFTWARE 
RELATIONSHIPS 

The hardware configuration needed to support Sort/ 
Merge Version 5 is the same as the minimum config- 
uration required for the NOS or NOS/BE operating 
system. One CDC CYBER 170 series host computer, 
together with peripheral processing units and disk 
subsystem is necessary. For installation, one tape 
unit is needed. Additionally, the interactive 
feature of Sort/Merge requires one 255x series 
communication subsystem. 

Sort /Merge Version 5 resides in a library named 
SRT5LIB on the NOS or NOS/BE operating system. 
Sort /Merge requires only the basic NOS or NOS/BE 
software. Sort/ Merge interfaces with CYBER Record 
Manager, which is one of the standard products 
released as part of both operating systems. 



Interactive use of Sort/Merge requires the Inter- 
active Facility (IAF) Version 1 under NOS or 
INTERCOM Version 5 under NOS/BE. IAF in turn 
interfaces with the network software Network Access 
Method (NAM). The NOS Version 2 Reference Set, 
Volume 1 (for NOS users) or the INTERCOM reference 
manual (for NOS/BE users) contains information . 
concerning terminal requirements. 



JOB FLOW 

You can use Sort/Merge for batch processing or 
interactively. For batch sort jobs, records to be 
sorted can be in permanent files, input in the same 
job with your S0RT5 control statement and param- 
eters, or supplied by an owncode routine. For 
merge processing, records must be in presorted 
files assigned to the job and named in the MERGE 
control statement. Sort/Merge uses CYBER Record 
Manager for input and output. Sorted or merged 
records can be written to a file and saved, listed 
by a printer, or processed by an owncode routine. 
Figure 1-1 illustrates batch job flow. 



Interactively, records to be sorted or merged can 
be in local files or in permanent files you assign 
to your job; records to be sorted can also be 
supplied by an owncode routine. You can enter the 
S0RT5 or MERGE control statement and processing 
parameters from your terminal, or you can use the 
interactive dialog to specify your sort or merge. 
At the end of the sort or merge, records are in a 
local file that can be displayed at your terminal, 
saved as a permanent file, or listed by a printer; 
output records can also be processed by an owncode 
routine. Figure 1-2 illustrates interactive 
job flow. 



1-2 
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SORT KEYS 



All sort or merge operations are based on the 
ordering of values assigned to the data to be 
sorted or merged, which are called sort keys. This 
section includes an explanation of sort keys and a 
discussion of the Information you must supply to 
describe sort keys to Sort/Merge. 



DEFINITION 

A sort key is a field of data within each record in 
an input file to be sorted or in a presorted file 
to be merged with one or more other files. The 
field is used by Sort/Merge to determine the order 
in which records are output. A file can be sorted 
or merged on more than one field of data; key 
fields must occur In the same position and be the 
same length in each record, and the total number of 
key characters must be less than 256 (if you also 
specify sum fields, the total number of characters 
in the key and sum fields together must be less 
than 256). Sort keys in files with variable length 
records cannot extend beyond the length of the 
shortest record in the file; the sort key field 
must be present in every record. For example, if 
the records range from a minimum of 25 characters 
to a maximum of 80 characters, all sort keys must 
be in the first 25 characters. 

The first key you specify is the most important key 
and is called a major sort key. The keys you 
specify after the first key are of lesser 
importance and are called minor sort keys. Each 
sort key describes the length of the field, the 
position of the field within each record, the type 
of data expected in that field, and the effect of 
that data on the sort order. When you specify 
multiple sort keys, the keys can differ as to type 
of data, collating sequence, and sort order. The 
alignment of data in sort keys is important. 
Character data must be left-justified in the field; 
numbers must be right-justified in the field. 

An example of a file with multiple sort keys is a 
university student file with a record for each 
student. Each record includes the last name and 
first and middle initials, the student number, the 
date of birth, the field of study, the grade point 
average, and a code representing class (freshman, 
sophomore, junior, senior); all the fields are 
written with character data. The file could be 
maintained with the student number as the major 
key - records are normally retrieved by specifying 
the student number. The file can be sorted by the 
name in standard alphabetic order when a list of 
student names Is needed. 

When a university department needs to know which 
students are majoring in fields within the 
department, the file can be sorted on the field of 
study. The same sort can specify the name as a 
minor key so that records with the same field of 
study are also sorted in alphabetic order by the 
name. The file can be sorted by the class code as 
the major key, and by the grade point average in 



descending numeric order as a minor key to give a 
list by class with the students having the highest 
grade point average at the beginning of the list. 



DESCRIBING SORT KEYS 

You must describe to Sort/Merge every field of data 
that you want used as a sort key. Sort key 
descriptions include the following information: 

• Starting location of the key within the record 

• Key length 

• Type of data in the key field 

• Sort order 

You describe sort keys with either the KEY 
parameter In a control statement or directive file, 
or with the SM5KEY procedure call. The options and 
defaults for describing sort keys are discussed in 
the following paragraphs . 

KEY LENGTH AND POSITION 

You define key field length and position by 
specifying the first byte or bit of the field and 
either the number of bytes or bits in the field 
(length of the field), or the last byte or bit of 
the field. The leftmost byte and the leftmost bit 
in a record are counted as number 1. For character 
data, each character is six bits and occupies one 
byte. For example, if you want to specify the name 
of the university student file as a sort key, and 
the name field is the leftmost field in the record, 
you specify the first byte as 1. If the name field 
is 20 characters long, you specify length as 20. 

Sort/Merge interprets the integers you specify for 
key length and position as bit numbers when the key 
type (discussed later in this section) specifies 
bits; otherwise, byte numbers are assumed. Key 
fields cannot overlap one another. No default 
exists for the starting location of a key within a 
record; you must specify the starting location. If 
you do not specify the length of a key, length 
defaults to 1. 



KEY TYPE 

You specify the type of data in a key field with 
the name of a collating sequence or with the name 
of a numeric data format. The data in a key field 
can be character or noncharacter. Character data 
Is represented in the computer as display code 
values. To indicate the key type for character 
data, you specify the name of a collating sequence 
or, for numeric character data, the name of a 
numeric data format. Noncharacter data is 
represented in the computer as binary values. To 
indicate the key type for noncharacter data, you 
specify the name of a numeric data format. 
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Figure 2-1 illustrates the difference between the 
internal representation of character and nonchar- 
acter data. Table 2-1 summarizes character and 
noncharacter data types and the associated sort 
key type. 



A. Character data 



— 


1 


2 


3 


4 



Octal equivalent of display code character 
29 24 18 12 6 



46 


34 


35 


36 


37 



B. Noncharacter data 



1234 



Octal equivalent of binary value 



59 

11. 




..775455 



Figure 2-1. Internal Representation of Character 
and Noncharacter Data 



If a sort key field contains any characters that 
are not meaningful for the key type you specify (an 
alphabetic character in a field defined as a 
numeric key for example), the sort order for that 
key field in that record is undefined. In the 
output file, the data for that key field in that 
record is also undefined. The record is still 
sorted according to any other sort keys you have 
specified. 



The collating sequences and numeric data formats 
you can specify are discussed in the following 
paragraphs . 



Collating Sequences 

A collating sequence determines the precedence 
given to each character in relation to the other 
characters . You specify a collating sequence for 
character data to determine the sort order. The 
data must be display code characters. 



Five predefined collating sequences are available 
to you as a Sort/Merge user: ASCII6, C0B0L6, 
DISPLAY, EBCDIC6, and INTBCD. The default col- 
lating sequence is ASCII6. Table 2-2 shows the 
predefined collating sequences. 



If none of the predefined collating sequences 
orders data as you would like, you can define a 
nonstandard collating sequence. If you are using 
control statement calls to Sort/Merge, you define 
your own collating sequence with SEQx parameters in 
the S0RT5 or MERGE control statement. If you are 
using the procedure calls, you define your own 
collating sequence with SM5SEQx procedure calls. 

Numeric Data Formats 

Numeric data can appear in a key field in one of 
the formats listed In table 2-3. Numeric data can 
be signed or unsigned. For character numeric data 
that is signed, the sign can be a floating sign, an 
overpunch representation over the leading (left- 
most) digit, a leading separate character, an over- 
punch representation over the trailing (rightmost) 
digit, or a trailing separate character. 



A floating sign is a negative sign embedded between 
leading blanks and the numeric characters; leading 
zeros must be converted to blanks. Positive values 
in this format are not signed. The following 
examples are valid floating sign formats: 

A A - 1 

A A A 1 

A A A 

12 3 4 



TABLE 2-1. DATA IN SORT KEY FIELDS 



Type 



Character 



Noncharacter 



Internal 
Representation 



Display code 



Binary value 



Data 
in Field 



Alphabetic 



Numeric 



Numeric 



Type 
Specified by 



Name of a collating 
sequence 



Name of a collating 
sequence 



Name of a numeric 
data format 

Name of a numeric 
data format 



Data Ordered 
According to 



Specified 
collating 
sequence 

Specified 
collating 
sequence 

Numeric 
value 

Numeric 
value 
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TABLE 2-2. PREDEFINED COLLATING SEQUENCES 





Collating 
Sequence 


ASCII6 


C0B0L6 


DISPLAY 


EBCDIC6 


INTBCD 




Decimal 


Octal 


Graphics 


Display 
Code 


Graphics 


Display 
Code 


Graphics 


Display 
Code 


Graphics 


Display 
Code 


Graphics 


CDC 

INTBCD 
Code 




00 


00 


blank 


55 


blank 


55 


:t 


00 


blank 


55 





00 




01 


01 


! 


66 


£ 


74 ^ 


A 


01 


, 


57 


1 


01 




02 


02 


H 


64 


*t 


63T 


B 


02 


< 


72 


2 


02 




03 


03 


# 


60 


[ 


61 


C 


03 


( 


51 


3 


03 




04 


04 


$. 


53. 


-* 


65 


D 


04 


+ 


45 


4 


04 




05 


05 


*t 


63T 


= 


60 


E 


05 


1 


66 


5 


05 




06 


06 


& 


67 


/\ 


67 


F 


06 


& 


67 


6 


06 




07 


07 


1 


70 


t 


70 


G 


07 
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53 


7 


07 




08 


10 


s 


51 


I 


71 


H 


10 


* 


47 


8 


10 




09 


11 


52 


> 


73 


I 


11 


) 


52 


9 


11 




10 


12 


* 


47 


> 


75 


J 


12 


> 


77 
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12 




11 


13 


+ 


45 


-, 


76 
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13 


—i 


76 
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12 


14 




56 
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57 
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14 


- 


46 
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14 




13 


15 


_ 


46 
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52 
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15 
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50 
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15 




14 


16 




57 




77 
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16 
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56. 
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16 




15 


17 


/ 


50 


+ 


45 





17 
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17 




16 


20 





33 


$ 


53 


P 


20 




65 


+ 


20 




17 


21 


l 


34 


* 


47 


Q 


21 


> 


73 


A 


21 




18 


22 


2 


35 


- 


46 


R 


22 


? 


71 


B 


22 




19 


23 


3 


36 


/ 


50 


S 


23 


: 


00 


C 


23 




20 


24 
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37 


I 


56 
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24 
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60 
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24 




21 


25 


5 


40 


51 
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74 
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41 
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70 
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26 
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7 


42 


* 


64 


w 


27 


m 


54 
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27 
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30 


8 


43 
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72 
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30 


if 


64 
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31 


9 


44 


A 


01 


Y 


31 


* 
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31 
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TABLE 2-3. NUMERIC DATA FORMATS 



Name 



NUMERIC LO 



NUMERIC LS 



NUMERIC TO 



NUMERIC TS 



Data Type 



Numeric characters 



Numeric characters 



Sign 



Numeric characters 



Numeric characters 



NUMERIC NS 



NUMERIC FS 



BINARY 



BINARY BITS 



INTEGER 



INTEGER BITS 



REAL 



Numeric characters 



Leading blanks, 
numeric characters 



Leading overpunch 



Leading separate 



Trailing overpunch 



Trailing separate 



None 



- sign for negative 
values; a + character 
is not allowed 



Binary integer 



Binary integer 



One's complement 
binary integer 



One's complement 
binary integer 



Normalized binary 
real or floating- 
point number 



None 



None 



Positive if leftmost 
bit is 0; negative if 
leftmost bit is 1 



Positive if leftmost 
bit is 0; negative if 
leftmost bit is 1 



Signed 



Comments 



All characters are decimal digits except the 
leading character, which indicates a sign by 
an overpunch. Data is ordered according to 
numeric value with negative zero ordered 
before positive zero. 

All characters are decimal digits except the 
leading character, which is a negative or 
positive sign. Specifying a field that is 
not at least two characters in length causes 
a fatal error. Data is ordered according to 
numeric value with negative zero ordered 
before positive zero. 

All characters are decimal digits except the 
trailing character, which indicates a sign by 
an overpunch. Data is ordered according to 
numeric value with negative zero ordered 
before positive zero. 

All characters are decimal digits except the 
trailing character, which is a negative or 
positive sign. Specifying a field that is 
not at least two characters in length causes 
a fatal error. Data is ordered according to 
numeric value with negative zero ordered 
before positive zero. 

All characters are decimal digits. Data is 
ordered according to numeric value. 

The field contains leading blanks (leading 
zeros must be converted to blanks); if the 
value is negative, the right-most leading 
blank must be converted to a minus sign. If 
the field contains no leading blanks, the 
value must be positive. This format is 
equivalent to the FORTRAN I format. Data is 
ordered according to numeric value with 
negative zero ordered before positive zero. 

The field starts and ends on character bound- 
aries. Data is ordered according to numeric 
value. 

The field does not start or end on character 
boundaries. Data is ordered according to 
numeric value. 

The field starts and ends on character bound- 
aries. Data is ordered according to numeric 
value with negative zero ordered before posi- 
tive zero. 

The field does not start or end on character 
boundaries. Data is ordered according to 
numeric value with negative zero ordered 
before positive zero. 

The field occupies a full computer word and 
is aligned on word boundaries. Data is 
ordered according to numeric value with all 
forms of zero ordered equally. The order of 
indefinite values is undefined. 
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The following examples are not valid floating sign 
formats: 

A A 1 Leading zero not allowed 

A - 1 Leading zero not allowed 

+12 3 Positive sign not allowed 

A A A A All blank field not allowed 



the collating sequence you specify. For numeric 
keys sorted in descending order, the record having 
the key with the lowest value is written last on 
the output file. Descending character keys are 
sorted in reverse order of the collating sequence 
you specify. The default sort order is ascending. 

TABLE 2-4. SIGN OVERPUNCH REPRESENTATION 



A negative sign overpunch is equivalent to 
overstriking a digit with a - , which is a punch in 
row 11. A positive sign overpunch is equivalent to 
overstriking a digit with a + , which Is a punch in 
row 12. When a signed overpunch digit is received 
as input, the digit is punched as indicated in the 
second column of table 2-4. When a signed 
overpunch digit is displayed as output, the digit 
appears as indicated in the third column of 
table 2-4. Noncharacter numeric data can be signed 
or unsigned binary integers or normalized floating- 
point numbers. 

You define numeric key fields by specifying the 
first byte of the field and either the length of 
the field or the last byte of the field. For types 
BINARYJBITS and INTEGERJBITS, you specify the first 
bit position of the field and either the length of 
the field in bits or the last bit of the field. 



SORT ORDER 

The order for sorting keys is ascending or 
descending. For numeric keys sorted in ascending 
order, the record having the key with the highest 
value is written last on the output file. 
Ascending character keys are sorted according to 



Sign and 


Input 


Output 


Digit 


Punch 


Representation 


+9 


12-9 


I 


+8 


12-8 


H 


+7 


12-7 


G 


+6 


12-6 


F 


+5 


12-5 


E 


+4 


12-4 


D 


+3 


12-3 


C 


+2 


12-2 


B 


+i 


12-1 


K 


+0 


12-0 


[t 


-0 


11-0 


]t 


-1 


11-1 


J 


-2 


11-2 


K 


-3 


11-3 


L 


-4 


11-4 


M 


-5 


11-5 


N 


-6 


11-6 





-7 


11-7 


P 


-8 


11-8 


Q 


-9 


11-9 


R 


'Valid on NOS with 029 keypunches. See 


appendix A, table A-2, f 


or NOS/BE repre- 


sentations of +0 and -0. 
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CONTROL STATEMENT SORTS OR MERGES 



This section describes Sort/Merge processing 

through control statement calls. The parameters 

that can appear in a SORTS or in a MERGE control 

statement are discussed, along with optional 
directive files. The CYBER Record Manager (CRM) 

requirements for control statement sorts or merges 
are explained. 



SORT5 CONTROL STATEMENT 

Sort/Merge sort capabilities are available through 
the S0RT5 control statement. Sort/Merge generates 
code based on the parameters you specify in the 
S0RT5 control statement (and directive files, if 
used) or on default values. Sort/Merge generates 
the code to make efficient use of memory, mass 
storage, and the central processor. 

The control statement begins with the word S0RT5, 
which must be followed by a period. The control 
statement can appear in one of the following forms: 



SORT5.pl,p2, ...,pn 



MERGE CONTROL STATEMENT 

Sort/Merge merge capabilities are available through 
the MERGE control statement. The input files for a 
merge must be presorted. Input files for a merge 
with summing must be presorted and presummed. When 
called with the MERGE control statement, Sort/Merge 
generates code based on the parameters you specify 
in the control statement (and directive files, if 
used) or on default values. Sort/Merge generates 
code to make efficient use of memory, mass storage, 
and the central processor. 

The control statement begins with the word MERGE, 
which must be followed by a period. The control 
statement can appear in one of the following forms: 

MERGE. pi, p2, ...,pn 

MERGE.pl Ap2 A ...Apn 

In the preceding control statement examples, p 
represents a processing parameter. Parameters must 
be separated by commas or spaces; commas and spaces 
can be used interchangeably. 



S0RT5 .pi A p2 A . . . A pn 



In the preceding control statement examples, p 
represents a processing parameter. Parameters must 
be separated by commas or spaces; commas and spaces 
can be used interchangeably. 

The SORTS control statement can be processed in a 
batch job or entered interactively from a ter- 
minal. The control statement must be CRM block 
type C (BT-C) and record type Z (RT=Z) format (see 
the CRM Basic Access Methods reference manual for 
information on block types and record types). Each 
line of the control statement can be up to 100 
characters in length; however, characters in excess 
of 80 are ignored. 

In interactive mode, control statements cannot be 
continued on more than one line. Instead, you can 
either create a directive file or use a procedure 
file so you can use a text editor to verify or 
change complex sort specifications. 

In batch mode, you can continue a control statement 
on more than one line by terminating the line with 
two or more periods and beginning the new line with 
one period. 

NOTE 

Continuation is not allowed for ranges 
(indicated by two periods); ranges must be 
started and completed on the same line. 



You can continue a control statement on any number 
of lines up to a maximum of 240 characters; periods 
used as continuation symbols are not included in 
the character count. 



The MERGE control statement can be processed in a 
batch job or entered interactively from a ter- 
minal. The control statement must be CRM BT=C and 
RT=Z format. Each line of the control statement 
can be up to 100 characters in length; however, 
characters in excess of 80 are ignored. 

In interactive mode, control statements cannot be 
continued on more than one line. Instead, you can 
either create a directive file or use a procedure 
file so you can use a text editor to verify or 
change complex sort specifications. 

In batch mode, you can continue a control statement 
on more than one line by terminating the line with 
two or more periods and beginning the new line with 
one period. You can continue a control statement 
on any number of lines up to a maximum of 240 char- 
acters; periods used as continuation symbols are 
not included in the character count. 



DIRECTIVE FILES 

A control statement sort or merge can use optional 
directive files that contain processing parameters 
in addition to the parameters in the S0RT5 or the 
MERGE control statement. Use of directive files 
allows specification of more complex sorts or 
merges (specifications that could be longer than 
allowed in a control statement) and permits stan- 
dardization of installation parameters and collat- 
ing sequences. 

You can specify multiple directive files for a 
single control statement sort or merge. All 
directive files must be CRM sequential files of 
block type C (BT-C) and record type Z (RT-Z) with 
record length (FL) of 100 characters or less; 
however, characters in excess of 80 are ignored. 
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In a directive file, each statement can be up to 
240 characters in length. Each statement must 
begin with the word SORT or with the word MERGE 
followed immediately by a comma or a space, and 
then followed by processing parameters, which are 
separated by commas or spaces. The following 
examples illustrate directive file formats: 

SORT,pl,p2,...,pn 

MERGE plAp2A...Apn 

You can continue a directive file statement on more 
than one line by terminating the line with two or 
more periods. The new line must not begin with a 
period but can begin with one or more spaces. You 
specify directive files in the S0RT5 or MERGE 
control statement with the DIR parameter, discussed 
in the Sort/Merge Parameters subsection. 



SORT/ MERGE PARAMETERS 

You specify various parameters in the S0RT5 or the 
MERGE control statement, or in a directive file, to 
direct Sort/Merge processing. Most parameters can 
appear either in a control statement or in a direc- 
tive file. The DIALOG parameter cannot appear in a 
directive file. Unless stated otherwise, a param- 
eter can appear only once in your sort or merge 
specification; a fatal error results if you specify 
duplicate parameters. You can specify parameters 
with keywords or by position in the control state- 
ment or directive file. When specified with 
keywords, parameters take one of the following 
forms, depending on the parameter: 

keyword=( (value-set ) [ , (value-set )]...) 

keyword=value 

Spaces can appear anywhere in a parameter except 
within a name, a number, or a range indicator. The 
order for specifying parameters by position follows 
the descriptions of the individual parameters. 
Refer to section 7 for information on owncode 
routines, which are mentioned in the descriptions 
of several of the parameters. 



FROM 

The FROM parameter (figure 3-1) specifies the input 
files from which the records to be sorted or merged 
are read. As many as 100 files can be sorted or 
merged in one job step. The files are read in the 
order that you specify them. The files are read 
past end-of -record marks; reading terminates when 
end-of-file or end— of— information is encountered 
(see the CRM Basic Access Methods reference 
manual). The files are rewound before and after 
use unless the name of the file is INPUT or a FILE 
control statement parameter specifies otherwise. 

If you specify the file $NDXL with the FROM param- 
eter, records to be sorted are not read from a 
file; records must be supplied by an owncode 
routine. You can specify the FROM parameter more 
than once in a directive file. If you omit the 
FROM parameter, records to be sorted are read from 
the file OLD (unless an owncode routine supplies 
records). An empty FROM file results in a null 
sort. 



FROM=lfn 

FROM={lfn1,lfn2 ) 

FROM=$NULL 

Ifn Logical file name; 1 to 7 letters or digits, 

beginning with a letter. 



Figure 3-1. FROM Parameter Format 



TO 

The TO parameter (figure 3-2) specifies the file to 
which sorted or merged records are written (if 
records are left after owncode routine process- 
ing). The file is not rewound before or after use 
unless a FILE control statement parameter specifies I 
otherwise. 



TO=lfn 

TO=$NULL 

Ifn 



Logical file name; 1 to 7 letters or digits, 
beginning with a letter. 



Figure 3-2. TO Parameter Format 

If you specify the file $NULL with the TO param- 
eter, sorted or merged records are not written to a 
file; you must supply an owncode routine to process 
all records. If you omit the TO parameter, records 
are written to the file NEW (unless an owncode 
routine processes all records). 



KEY 

The KEY parameter (figure 3-3) specifies the key 
fields that determine the sorted or merged order of 
output records. You can specify the KEY parameter 
more than once in a directive file on separate 
command lines. A maximum of 100 key fields can be 
specified. 

Each key_def defines a separate key. They are 
defined in the order of precedence, from major key 
to minor key, read left to right. A key_def may 
consist of a range. A range consists of the first 
and last byte of the key, separated by two 
periods. A single integer may be considered as a 
special case of a range in which the first and last 
byte are the same. If a key_def consists of 
anything more than a range, it must be enclosed 
within parentheses, or else it will be processed as 
a multiple key sort. 

The key position and length are the first byte of 
the field and either the number of bytes or bits in 
the field (length of the field) or the last byte or 
bit of the field. You specify first and length (or 
last) as integers; the leftmost byte and the 
leftmost bit in a record are counted as number 1. 
For character data, each character is six bits and 
occupies one byte. For all types of data, first 
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KEY = 


("(key_def [,key_def] ...)] 
|_range J 


key def ("range 1 
(range[,type[,ad] ] ) 
Ufirst.length[,typet^d]])J 


range 


[first 1 
[first., last J 


first 


First byte or bit of the key field. 


last 


Last byte or bit of the key field. 


length 


Number of bytes or bits in the key field; 
default is 1. 


type 


Name of a numeric data format or 
collating sequence; default is ASCI 1 6. 


ad 


Order: A for ascending, D for descend- 
ing; default is ascending. 



Figure 3-3. KEY Parameter Format 

and length (or last) refer to bytes except for the 
formats BINARYJBITS and INTEGER_BITS . You must 
specify the first byte or bit of a key field. If 
you do not specify otherwise in the KEY parameter, 
the key length is assumed to be 1. 

The key type is the name of a predefined or 
user-defined collating sequence or the name of a 
numeric data format. If you do not specify a key 
type, the type is assumed to be the ASCI 16 
collating sequence. See section 2 for a list of 
predefined collating sequences and numeric data 
formats. 

Sort order is either ascending or descending, and 
you specify A or D, respectively. If you specify 
neither, the sort order is assumed to be 
ascending. For numeric keys sorted in ascending 
order, the record having the key with the highest 
value is written last on the output file. 
Ascending character keys are sorted according to 
the collating sequence you specify. For numeric 
keys sorted in descending order, the record having 
the key with the lowest value is written last on 
the output file. Descending character keys are 
sorted in reverse order of the collating sequence 
you specify. 

Records are first sorted according to the key field 
described by the leftmost keyjdef. Records with 
equal values for the major key field are sorted 
according to the field described by the next 
key_def, and so on. A fatal error occurs if key 
fields overlap one another. A fatal error also 
occurs if the total number of key characters is 
more than 255. (If you also specify sum fields, 
the total number of characters in the key and sum 
fields together must be less than 256.) 

You must be careful when defining a sort with a 
single key. The following command defines a single 
key that is 20 bytes long, starting in byte 6: 

S0RT5. KEY=6..25 



The following command defines the same sort key: 

S0RT5. KEY=((6,20)) 

The following command defines a sort on two single 
byte keys where byte 6 is the major key and byte 20 
is the minor key: 

S0RT5. KEY=(6,20) 

If you omit the KEY parameter, the following 
assumptions are made: KEY=1.. (minimum record 
length) , the record length is the smallest HNR in 
the FILE control statements for input files (or the 
smallest FL for F and Z records), the key type is 
the ASCII6 collating sequence, and the sort order 
is ascending. 



DIR 



The DIR parameter (figure 3-4)" specifies a direc- 
tive file or files from which sort or merge param- 
eters are read. Parameters in a directive file are 
read only after all of the control statement param- 
eters have been read. The files are read in the 
order that you specify them. The files are rewound 
before and after use unless the name of the file is 
INPUT or a FILE control statement parameter speci- 
fies otherwise. 



DIR= 


=lfn 














DIR= 


=(lfn1,lfn2 ) 












Ifn 




Logical file name 
beginning with a 


1 to 
letter. 


7 


letters 


or 


digits. 



Figure 3-4. DIR Parameter Format 

You can specify the DIR parameter more than once in 
a directive file. If you omit the DIR parameter, 
no parameters are read from a directive file; the 
sort or merge is completely specified in the S0RT5 
or the MERGE control statement. 



The L parameter (figure 3-5) specifies the file to 
which listing information is written. The listing 
file is written in CRM BT=C, RT-Z format with a 
default full length of 132. Listing information 
includes the Sort/Merge version number, directive 
file statements, the time and date, and diagnostic 
messages, if any. 



L=lfn 




L=$NULL 




Ifn 


Logical file name; 1 to 7 letters or digits, 
beginning with a letter. 



Figure 3-5. L Parameter Format 
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The listing file is not rewound before or after use 
unless a FILE control statement parameter specifies 
rewind. If you specify the file $NULL with the L 
parameter, listing information is not written. If 
you omit the L parameter, listing information is 
written to the file OUTPUT. 



The E parameter (figure 3-6) specifies the file to 
which diagnostic messages are written. The error 
file is written in CUM BT=C, RT=Z, and FL=72 
format. The file is not rewound before or after 
use unless a FILE control statement parameter 
specifies to rewind. 



DIALOG 

The DIALOG parameter (figure 3-8) invokes an inter- 
active dialog between you and Sort/Merge. The 
DIALOG parameter can appear only in a control 
statement. If DIALOG=YES, the dialog is invoked; 
if DIALOG=NO, the dialog is not invoked. Omitting 
the DIALOG parameter is equivalent to DIALOG=UO. 
The DIALOG parameter can be abbreviated as DIA, and 
Y or N can be specified instead of YES or NO. Any 
other parameters (except the STATUS parameter) 
specified in a control statement along with the 
DIALOG parameter do not affect sort or merge proc- 
essing; the sort or merge is performed solely on 
the basis of your dialog responses. Interactive 
use of the dialog is described in section 4, and 
the text of the dialog is included in appendix E. 



E=lfn 

E=$NULL 

Ifn 



Logical file name; 1 to 7 letters or digits, 
beginning with a letter. 



Figure 3-6. E Parameter Format 

If you specify a listing file with a file name 
different from the error file name, diagnostic 
messages are written to the listing file and to the 
error file. If you specify the file $NULL with the 
E parameter, diagnostic messages are not written. 
If you omit the E parameter, diagnostic messages 
are written to the listing file. 



The EL parameter (figure 3-7) specifies the error 
level to be reported. If EL=T, all trivial errors, 
plus all errors of levels W, F, and C, are 
reported. If EL=W, all warning errors, plus all 
errors of levels F and C, are reported. If EL=F, 
all fatal errors, plus all errors of level C, are 
reported. If EL=C, all catastrophic errors are 
reported. Omitting the EL parameter is equivalent 
to EL=W. 



DIALOGUES (or DIA=Y) 
DIALOG=NO (or DIA=N) 



Figure 3-8. DIALOG Parameter Format 



ENR 



The ENR parameter (figure 3-9) specifies the esti- 
mated number of records to be sorted or merged. 
You specify either a single value or a range of 
values, and decimal integers (from through 
1000000000) or the CYBER Control Language (CCL) 
variables Rl, R2, R3, RIG, EF, or EFG. If ENR is 
specified as less than 1500, Sort/Merge uses less 
memory for the initial sort phase. This causes 
noticeably less memory required for the entire sort 
if the actual number of records is a low number. 



ENR=expr 




ENR=expr 


. . expr 


expr 


Expression that is a decimal integer, or CCL 
variable R1,R2,R3,R1G,EF. or EFG. 



Figure 3-9. ENR Parameter Format 




Figure 3-7. EL Parameter Format 

Errors are written to the error file or, if no 
error file is specified, to the listing file. See 
appendix B for an explanation of the four levels of 
errors. 



OWNF 

The OWNF parameter (figure 3-10) specifies the file | 
that is the source of owncode routines; the file, 
which must contain relocatable object modules, is 
loaded by Sort /Merge by means of the user call 
loader. The load map from loading the routines is 
written to file ZZZZZLM. 



OWNF=lfn 

Kn Logical file name; 1 to 7 letters or digits, 

beginning with a letter. 



Figure 3-10. OWNF Parameter Format 
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OWNFL 

] The OWNFL parameter (figure 3-11) specifies the 
exact number of characters in all records entering 
the sort from an owncode routine. The integer you 
specify can be from 1 to 5000 (larger records can 
be sorted if field length is increased). The OWNFL 
parameter can be abbreviated as OFL. See the 
discussion of the OWNMRL parameter for default 
values . 



OWNFL=integer 
OFL=integer 



Figure 3-11. OWNFL Parameter Format 



OWNMRL 

| The OWNMRL parameter (figure 3-12) specifies the 
maximum length in characters of any record entering 
the sort from an owncode routine. The integer you 
specify can be from 1 to 5000 (larger records can 
be sorted if field length is increased). The 
OWNMRL parameter can be abbreviated as 0MRL. You 
do not need to specify the OWNMRL parameter if the 
sort has an input or output file with a maximum 
record length at least as long as the longest 
record supplied by an owncode routine. 



OWNMRL=integer 
OMRL=integer 



Figure 3-12. OWNMRL Parameter Format 

If you omit both the OWNMRL and the OWNFL param- 
eters, the record length specification of records 
entering the sort from an owncode routine depends 
on the length specifications of the input and 
output files. If all input and output files have 
fixed length records of the same length, this 
length is used as a default OWNFL value; otherwise, 
the largest MRL or FL from any input or output file 
is used as a default OWNMRL value. 

If the sort has no input or output files (records 
to be sorted are supplied by an owncode routine and 
sorted records are processed by an owncode rou- 
tine), you must specify either OWNFL or OWNMRL; 
otherwise, a fatal error results. You cannot 
specify both the OWNFL and OWNMRL parameters for 
the same sort. Use of OWNFL rather than OWNMRL can 
increase performance. 



OWNn 

| The OWNn parameter (figure 3-13) specifies the name 
of an owncode routine that is executed each time 
point n is reached during the sort or merge; n must 
be 1, 2, 3, 4, or 5. Owncode routines named by the 
OWNn parameter must be in the 0WNF file. All 
owncode routines are loaded before the sort or 
merge is started. If you omit the OWNn parameter, 
no owncode routine is executed. 



OWNn= 


=proc 






n 


1, 2. 3, 4. or 5 






proc 


Procedure-name; 1 to 31 letters, digits or 
the special characters ? # @ _. Only 7 
characters are significant and the first must 
be a letter. 



Figure 3-13. OWNn Parameter Format 



RETAIN 

The RETAIN parameter (figure 3-14) directs Sort/ | 
Merge to output records with equal sort keys in the 
same order as the records are input (RETAIN-YES). 
If RETAIN=N0, or if you omit the RETAIN parameter, 
records with equal sort keys might not be output in 
the same order as they are input. If RETAIN=YES 
and you specify more than one sort or merge input 
file with the FROM parameter, the order in which 
you specify the files is the order in which records 
with equal keys are output. The RETAIN parameter 
can be abbreviated as RET, and Y or N can be speci- 
fied instead of YES or NO. 



RETAIN=YES (or RET=Y) 
RETAIN=NO (or RET=N) 



Figure 3-14. RETAIN Parameter Format 

You cannot specify both the RETAIN and the SUM 
parameters in the same sort or merge. If you do 
specify both, a catastrophic error occurs. 



SEQx 

The SEQx parameters (figure 3-15) define your own 
collating sequence. The SEQN parameter signals the 
start of your collating sequence definition and 
names the sequence; name is used as the key type in 
the KEY parameter when records are sorted according 
to your collating sequence. Specifying a name that 
is the same as the name of one of the predefined 
collating sequences results in a fatal error. 



SEQN=name 
SEQS=( , char', 



'char') 



[SEQR=YES or SEQR=Y] 
[SEOA=YES or SEOA=Y] 

name Collating sequence name; 1 to 31 letters, 

digits, or the special characters ? # @ 

Only 10 characters are significant and the 
first must be a letter. 

char Character in the collating sequence. 



Figure 3-15. SEQx Parameter Formats 
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Collating positions are assigned to the characters 
in your collating sequence by SEQS parameters ; each 
SEQS parameter specifies either a single value step 
or a range of value steps in the sequence. A value 
step consists of one or more characters, and 
characters specified in the same value step collate 
equally. The first SEQS parameter specifies the 
first value step or range of steps, the second SEQS 
parameter specifies the second value step or range 
of steps, and so on until your collating sequence 
is completely defined. The following paragraphs 
describe how to specify steps in your collating 
sequence with SEQS parameters. 



SEQS=$CHAR(08) 

You can specify a single value step consisting of 
several characters by a single character enclosed 
in apostrophes, followed by one or more characters 
and/or ranges of characters. The characters are 
enclosed in apostrophes. All characters specified 
or implied in such a step collate equally. The 
following example specifies a step consisting of 
the blank and the digits 0, 1, 2, and 3, all of 
which collate equally: 

SEQS=(' VOVl','2','3') 



You can specify a single value step consisting of a 
single character by a graphic character (see 
appendix A) enclosed in apostrophes as in the 
following example: 

SEQS-'A' 



You can also specify a single value step consisting 
of a single character by $CHAR(n) where n is the 
number of the character in the character set at 
your site (see table 3-1). The following example 
specifies a step consisting of the character number 
08 in the character set, which is the letter H: 



The following example specifies the same value step 
as a range of characters where '0'..'3' specifies 
the range of digits from through 3: 

SEQS=(' ','0'..'3') 

You can specify several value steps, each consist- 
ing of one character, with one value that is a 
range of characters. The characters are enclosed 
in apostrophes. The following example specifies a 
four-step collating sequence consisting of the 
digits 0, 1, 2, and 3, with assigned the lowest 
collating value: 

SEQS=('0'..'3') 



TABLE 3-1. $CHAR(n) CHARACTER NUMBERS 



Character 


CDC Graphic 


ASCII Graphic 


Octal 

6-Bit 

Display 

Code 


Character 


CDC Graphic 


ASCII Graphic 


Octal 
6-Bit 


Dumber 


( 64-Charac- 


(64 Charac- 


Number 


(64-Charac- 


(64 Charac- 


(decimal) 


ter Set)t 


ter Set)t 


(decimal) 


ter Set)t 


ter Set)t 


Display 
Code 


00 


. 


. 


00 


32 


5 


5 


40 


01 


A 


A 


01 


33 


6 


6 


41 


02 


B 


B 


02 


34 


7 


7 


42 


03 


C 


C 


03 


35 


8 


8 


43 


04 


D 


D 


04 


36 


9 


9 


44 


05 


E 


E 


05 


37 


+ 


+ 


45 


06 


F 


F 


06 


38 


- 


- 


46 


07 


6 


G 


07 


39 


* 


* 


47 


08 


H 


H 


10 


40 


/ 


/ 


50 


09 


I 


I 


11 


41 


< 


( 


51 


10 


J 


J 


12 


42 


) 


) 


52 


11 


K 


K 


13 


43 


$ 


$ 


53 


12 


L 


L 


14 


44 




a 


54 


13 


M 


H 


15 


45 


blank 


blank 


55 


14 


N 


N 


16 


46 


» 


i 


56 


15 








17 


47 


. 




57 


16 


P 


P 


20 


48 


s 


# 


60 


17 


Q 


Q 


21 


49 


t 


[ 


61 


18 


R 


R 


22 


50 


] 


i 


62 


19 


S 


S 


23 


51 


X 


X 


63 


20 


T 


T 


24 


52 


= 


n 


64 


21 


U 


U 


25 


53 


r 




65 


22 


V 


V 


26 


54 


V 


T 


66 


23 


W 


W 


27 


55 


A 


& 


67 


24 


X 


X 


30 


56 


t 


' 


70 


25 


Y 


Y 


31 


57 


4 


t 


71 


26 


Z 


Z 


32 


58 


< 


< 


72 


27 








33 


59 


> 


> 


73 


28 


1 


1 


34 


60 


< 


e 


74 


29 


2 


2 


35 


61 


> 


\ 


75 


30 


3 


3 


36 


62 


— 1 


* 


76 


31 


4 


4 


37 


63 


J 


5 


77 


'For 63-chai 


racter set differences, see the 


subsection entitled Charac 


ter Set Anomal 


.es in appendix A 
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The preceding example is the same as specifying the 
following: 

SEQS='0' 
SEQS='l' 
SEQS='2' 
SEQS='3' 

You can specify several value steps, each of which 
consists of more than one character, as ranges of 
characters where each range has the same number of 
characters. One value step in the collating 
sequence results for each character implied by the 
range. The characters are enclosed in apostro- 
phes. A diagnostic message is issued if each range 
does not consist of the same number of characters. 
The following example specifies a three-step 
collating sequence where the first step consists of 
1 and A (which are assigned the lowest collating 
value); the second step is 2 and B; the third step 
is 3 and C: 

SEQS=('1'..'3','A'..'C) 

The preceding example is the same as specifying the 
following: 

SEQS=('1','A') 
SEQS=('2','B') 
SEQS=('3','C) 

Any SEQS parameter that specifies a range of 
characters followed by a single character results 
in a fatal error. An apostrophe is specified in a 
SEQS parameter by four apostrophes (""). You can 
specify the SEQS parameter more than once in a 
directive file. SEQS parameter use is summarized 
in table 3-2. 

You can use one SEQR parameter to define a special 
value step that consists of all characters not 
explicitly or implicitly specified with SEQS param- 
eters; either YES or Y is allowed. The following 
example defines a sequence in which the digits 
collate in numeric order, then all special char- 
acters (such as periods, commas, slashes) collate 
equally, and then letters collate in alphabetic 
order : 



SEQS=('0'..'9') 

SEQR=YES 

SEQS=('A'..'Z') 

You can specify one SEQA parameter to alter in 
output records characters in the same value step to 
the first character in the step; either YES or- Y is 
allowed. The following example alters all aster- 
isks and ampersands to slashes: 

SEQS»(7', '*','&') 
SEQA=YES 

Your collating sequence specification is terminated 
by any parameter other than SEQS, SEQR, or SEQA. 
You can define as many as 100 collating sequences 
by specifying a separate series of SEQx parameters 
for each collating sequence. The name of each 
user-defined collating sequence in a sort or merge 
must be unique. If you omit the SEQx parameters, a 
nonstandard collating sequence is not defined. 



STATUS 

The STATUS parameter (figure 3-16) specifies that a 
CYBER Control Language (CCL) variable be set to a 
value representing the highest level of error that 
occurred during the sort or merge. The CCL vari- 
ables Rl, R2, R3, RIG, EF, or EFG can be used for 
this purpose. Table 3-3 shows values that can be 
returned in the specified variable. For example, 
if you specify STATUS=R1 and Rl subsequently 
contains 20, a trivial error occurred. 



STATUS=variable (or ST=variable) 

variable CCL variable Rl, R2, R3, R1G, EF, or EFG. 



Figure 3-16. STATUS Parameter Format 

If you include the STATUS parameter in your sort or 
merge specification, Sort/Merge does not abort if a 
catastrophic error occurs before any data records 
are input. However, if Sort/Merge calls another 



TABLE 3-2. SEQS PARAMETER SUMMARY 



Number of Value 
Steps Specified by 
One SEQS Parameter 


Number of Characters 
in Each Value Step 


How Specified 


Example 


1 step 


1 character 


Graphic character or $CHAR(n) 
where n is the number of the char- 
acter in your character set. 


SEQS-'H' or 
SEQS=$CHAR(08) 


1 step 


More than one 
character 


Each character in the step is 
enclosed in apostrophes and sepa- 
rated by commas , or a single char- 
acter is followed by one or more 
ranges of characters. 


SEQS=('I','0','X') or 
SEQS=(':','0'..'9') 


More than one step 


1 character 


One range of characters. 


SEQS=('0'..'9') 


More than one step 


More than one 
character 


Ranges of characters where each 
range has the same number of char- 
acters . 


SEQS=('A'..'E','V'..'Z') 
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TABU) 3-3. ERROR LEVEL CODES, STATUS PARAMETER 



Error Level « 


Code 


No errors 





Trivial 


20 


Warning 


30 


Fatal 


40 


Catastrophic 


50 



product and an unrecoverable error results , an 
abnormal job termination will occur. For example, 
if Sort/Merge called a product, such as Common 
Memory Manager (CMM), and CMM processing results in 
an error, a termination will occur. If you omit 
the STATUS parameter, no error status variable is 
set, and Sort/Merge aborts if a catastrophic error 
occurs. The STATUS parameter can be abbreviated as 
ST. 



SUM 

The SUM parameter (figure 3-17) specifies the 
fields that are to be summed in records with equal 
key values. Input files for a merge with summing 
must be presorted and presummed. As many as 255 
bytes can be summed. The records with all key 
fields equal are combined into one new record, and 
the other records with equal keys are deleted. The 
one resultant record contains the key fields and 
the fields that are the sums of the specified 
fields from all the records with equal keys; a data 
field that is not a key field or a sum field is set 
to the corresponding field from one of the old 
records. 



SUM = ((sum_def)[,(sum_def)] . . . ) 


sum_def 


[(first,length,[type[,rep] ] )1 
L(range[,type[,rep]]) J 


range 


[first 1 
|_first . . last J 


first 


First byte or bit of the sum field. 


last 


Last byte or bit of the sum field. 


length 


Number of bytes or bits in the sum field; 
default is 1. 


type 


Name of a numeric data format (except 
REAL); default is INTEGER. 


rep 


Number of fields to be summed; default 
is 1. 



Figure 3-17. SUM Parameter Format 



All the fields to be summed must contain numeric 
data; otherwise, the contents of the new fields are 
undefined. The fields described as sum fields 
cannot also be key fields. 



In figure 3-17, a key_def describes a field to be- | 
summed by specifying the field length and position, 
a numeric data format, and the number of fields to 
be summed. The field length and position are the 
first byte or bit of the field, and either the 
number of bytes or bits in the field (length of the 
field), or the last byte or bit of the field. You 
specify first and length (or last) as integers; the 
leftmost byte and the leftmost bit in a record are 
counted as number 1. First and length (or last) 
refer to bytes except for formats BINARYJBITS and 
INTEGER_BITS. You must specify the first byte or 
bit of the sum field. If you do not specify 
otherwise in the SUM parameter, the key length is 
assumed to be 1. 



Sum field type is the name of a numeric data format 
except REAL; fields containing data in REAL format 
cannot be summed. You must specify the sum field 
type; no default exists. See section 2 for a list 
of numeric data formats. The number of fields to 
be summed is specified as an integer; the default 
is 1. If you specify multiple fields with one SUM 
parameter, the fields must be consecutive, must be 
the same length, and must contain the same type of 
numeric data. Sum fields cannot overlap one 
another. If a sum field contains no data because a 
record is short, the sum for that field is unde- 
fined. If you do not specify a sum type, the type 
is assumed to be INTEGER. 



Figure 3-18 shows an example of a SUM parameter. 
Part A of figure 3-18 shows the layout of the 
record containing the fields to be summed. Part B 
shows three SUM parameters, each describing one 
field to be summed. Part C shows one equivalent 
SUM parameter that describes the three consecutive 
fields to be summed. Note that when you specify a 
single value-set, two sets of parentheses are still 
required. 



If the summing of the specified fields results in 
new numeric values that do not fit into the sum 
fields, a fatal error results. One of the records 
that caused the overflow is deleted as usual, but 
the sum field contents in the remaining record are 
undefined. A diagnostic message indicating which 
field caused the overflow is issued, and the job 
step is terminated at the end of the sort (unless 
you include the STATUS parameter). 



You can specify the SUM parameter more than once in 
a directive file. If you omit the SUM parameter, 
records with equal key values are not automatically 
combined into single records. You cannot specify 
both the SUM parameter and an owncode 5 routine for 
the same sort or merge. You cannot specify both 
the RETAIN parameter and the SUM parameter in the 
same sort or merge. If you do specify both, a 
catastrophic error occurs. 
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A. Record Layout 

1 10 15 20 25 




Student number 
(sort key) 


Number of 
units registered 


Number of 
units completed 


Grade points 




B. SUM Parameters 

SUM=((11,5,INTEGER)) 
SUM=(06,5,INTEGER)) 
SUM=((21,5,INTEGER» 

C. SUM Parameter 

SUM=((11,5,INTEGER,3» 



Figure 3-18. SUM Parameter Example 



VERIFY 

| The VERIFY parameter (figure 3-19) directs Sort/ 
Merge to check merge input records for correct 
order. This parameter applies only if you are 
performing a merge. If a merge input record is out 
of order when you have specified VERIFY=YES, the 
merge is terminated (regardless of the STATUS 
parameter) and a diagnostic message is issued. If 
VERIFY=N0, merge input records are not checked for 
correct order. Omitting the VERIFY parameter is 
equivalent to VERIFY=N0. You can specify VER 
instead of VERIFY, and Y or N instead of YES or 
NO. The VERIFY parameter is ignored if you are 
performing a sort. 



VERIFY=YES (or VER=Y) 
VERIFY=NO (or VER=N) 



Figure 3-19. VERIFY Parameter Format 



FASTIO 

The FASTIO parameter (figure 3-20) specifies that 
certain sort or merge input and output records are 
to be read and written directly by Sort/Merge 
rather than by means of CYBER Record Manager 
(CRM). The FASTIO parameter is ignored during a 
merge. Files processed by the FASTIO parameter 
must reside on mass storage. The records in these 
files must be block type C and record type F, or 
block type I and record type W (see the CRM Basic 
Access Methods reference manual for detailed 
information). All input files must have identical 
record types and record lengths. If the file 
resides on tape, or if the records are not all the 
same type and length, a warning diagnostic is 
issued and the FASTIO option is canceled. The 
files are then processed using CRM. Sort/Merge 
obtains block and record type information from the 
file information table (FIT); a FILE control 
statement is not ignored. Specifying the FASTIO 
parameter results in increased speed, but not all 
errors are diagnosed; use this parameter when you 
are sure your files are correctly written and 
described. 



FASTIO=YES 
FASTIONO 



(or FASTIO=Y) 
(or FASTION) 



Figure 3-20. FASTIO Parameter Format 

If FASTIO=YES, all sort or merge input and output 
files with block type C and record type F, or block 
type I and record type W, are read directly by 
Sort/Merge. If FASTI0=N0, all sort or merge input 
and output files are processed using CRM. Omitting 
the FASTIO parameter is equivalent to FASTI0=N0. 
You can specify Y or N instead of YES or NO. 



SPECIFYING PARAMETERS 
BY POSITION 

You can specify any of the Sort/Merge parameters in 
a control statement or in a directive file without 
a keyword by supplying a value in the position 
assigned to that particular keyword. Table 3-4 
lists the parameter keywords and the position 
assigned to each. Omitted parameters are replaced 
by commas. For example, the following control 
statements are equivalent: 

S0RT5.INFL,0UTFL,5. .9, , , ,F 

S0RT5.FROM=INFL,T0=OUTFL,KEY=5..9,EL=F 

The two preceding control statements specify that 
records to be sorted are in the file INFL, and 
sorted records are to be written to file OUTFL. 
The sort key field begins with the fifth character 
of each record, and the last character of the key 
field is the ninth character of the record. Fatal 
and catastrophic errors are to be reported. 

You can mix keyword specification and positional 
specification of parameters in the same control 
statement or directive file. Whenever you specify 
a parameter with a keyword, the parameter retains 
its position number (table 3-4). Any positional 
parameters you specify after a keyword parameter 
are numbered according to the position number of 
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TABLE 3-4. PARAMETER POSITIONAL ORDER 



Parameter 
Keyword 


Position 
Number 


FROM 


1 


TO 


2 


KEY 


3 


DIR 


4 


L 


5 


LO 


6 


E 


7 


EL 


8 


DIALOG 


9 


ENR 


10 


Reserved for 
future use 


11 


Reserved for 
future use 


12 


OWNF 


13 


OWNFL 


14 


OWNMRL 


15 


Reserved for 
future use 


16 


0WN1 


17 


OWN2 


18 


0WN3 


19 


OWN4 


20 


0WN5 


21 


RETAIN 


22 


SEQA 


23 


SEQN 


24 


SEQR 


25 


SEQS 


26 


STATUS 


27 


SUM 


28 


Reserved for 
future use 


29 


VERIFY 


30 


FASTIO 


31 



the last keyword parameter you specified. The 
following example illustrates mixing keyword and 
positional parameters: 

S0RT5.DIR=DIRFIL, , , , , ,6000,RET=Y, , , , ,EFG 



The DIR parameter is position number 4. 
replace parameters 5 through 9. The estimated 
number of records (6000) is position number 10. 
Numbering begins again with a keyword parameter 
(BETAIN number 22). Commas replace parameters 23 
through 26. The positional value EF6 is the status 
variable (STATUS number 27). 



FILE CONTROL STATEMENT 

Unless default characteristics apply for a file, 
you must specify the characteristics of all input 
and output data files named in a S0RT5 or a MERGE 
control statement, or in a directive file, with a 
CYBER Record Manager (CRM) FILE control statement. 
FILE control statements must precede the SORT5 or 
the MERGE control statement. The format of the 
FILE control statement is shown in figure 3-21. 



FILE(lfn]>eyword=option] . . . ) 

Ifn Logical file name; 1 to 7 letters or 

digits, beginning with a letter. 

keyword=option Symbolic name of the file information 
table (FIT) field and the option 
selected. 



Figure 3-21. FILE Control Statement Format 

The file information table (FIT) is a table through 
which file characteristics are communicated to CRM 
Basic Access Methods; the FIT contains information 
that describes the file and specifies how the file 
is accessed. You set FIT fields by specifying the 
symbolic name of the field in the FILE control 
statement and selecting one of the options associ- 
ated with that field. Several FIT fields important 
to Sort/Merge processing are discussed in the 
following paragraphs. The CRM Basic Access Methods 
reference manual contains a complete list of all 
FIT fields and options that you can select. Note 
that specification of certain FIT fields can 
require setting of additional FIT fields. 

Input files to be sorted or merged, and output 
files to which sorted or merged records are writ- 
ten, must be sequential files (records are read and 
written in order one after the other). The file 
organization (FO) FIT field can be included in the 
FILE control statement and sequential organization 
specified (F0=SQ); you can omit this parameter and 
sequential organization is assumed. 

Sequential files are organized into groups of 
records called blocks. Block type is specified 
with the block type (BT) FIT field. The default is 
BT=C. CBM also offers several record types, and 
any of these record types except U can be sorted or 
merged. Record type is specified with the record 
type (RT) FIT field. The default is RT=Z. The 
full length (FL) or maximum record length (MRL) FIT 
field must be set to establish the number of char- 
acters in a record. The default is FL=150 or 
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MRL=150. The default is also a satisfactory- 
description for records of less than 150 char- 
acters. If you have any files of considerably less 
than 150 characters (25 characters for example), 
Sort /Merge can perform more efficiently If you 
include a FILE control statement. 

Default CRM characteristics apply for the files 
INPUT, OUTPUT, and PUNCH. You do not need to 
include FILE control statements for these files. 

Table 3-5 summarizes the default file characteris- 
tics for Sort/Merge input and output data files, 
directive files, the error and listing files, and 
the files INPUT, OUTPUT, and PUNCH. 



TABLE 3-5. FILE CHARACTERISTICS 



SPECIFYING MAXIMUM 
RECORD LENGTH 



Unless default characteristics apply for a file, . 
Sort/Merge requires that you specify maximum record 
length for input and output data files. You 
specify maximum record length by setting the FL or 
HRL FIT field in the FILE control statement. Set 
the FL FIT field for F or Z type records to specify 
the length of each record (if RT=F), or the upper 
limit of characters in a record (if RT«Z). For all 
other record types, set the MRL FIT field to 
specify the maximum length of a record. 



^S. FIT 








\. Field 


BT 


RT 


FL 


File ^S. 








FROM files 


C 


Z 


FL<150 


TO file 


C 


Z 


FL<150 


DIR files 


C 


Z 


FL<100 


L file 


C 


Z 


FL=132 


E file 


C 


Z 


FL-72^ 


INPUT 


C 


Z 


FL-80 


OUTPUT 


C 


Z 


FL-140 


PUNCH 


C 


Z 


FL-80 


'If E-OUTPUT, 


FL-140 is t 


jsed. 





FIELD LENGTH REQUIREMENTS 

The minimum field length required for control 
statement sorts or merges is 55000g words; the 
default field length is 60000g words. Records up 
to 5000 characters in length can be sorted when 
your job is using the default field length. Large 
sort or merge operations can require additional 
central memory. The memory needed for a merge is 
directly proportional to the number of input files 
you have, because all files are simultaneously 
open. The default file buffer size (BFS) is 
2001g words. You can change this value with the 
FILE control statement to save memory. 



LISTINGS 

If an error occurs during the sort or merge, the 
message S0RT5 - USER ERROR, JOB ABORTED is sent to 
your job dayfile. Otherwise, when the sort or 
merge is complete, a message indicating the number 
of records sorted or merged is sent to the dayfile. 
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INTERACTIVE USE 



Sort/Merge capabilities are available interac- 
tively; you can specify any of the Sort/Merge 
parameters from your terminal. Sort/Merge also 
provides a tutorial dialog to aid In specifying 
parameters. This section describes the use of this 
dialog, Sort/Merge interactive commands, and login 
and logout processes. The complete text of the 
dialog is included in appendix E. 



In Interactive mode, control statements cannot be 
continued on more than one line. Instead, you can 
either create a directive file or use a procedure 
file so you can use a text editor to verify or 
change complex sort specifications. 



TERMINAL ACCESS TO 
SORT/MERGE 



To access Sort/Merge from your terminal, you first 
establish the physical connection between the 
terminal and the computer. The method of estab- 
lishing the connection varies depending on the type 
of terminal and the coupling between the terminal 
and computer. Consult the NOS Version 2 Reference 
Set, Volume 1 (for NOS users) or the INTERCOM 
reference manual (for NOS/BE users) for information 
on connection methods. 



Connecting your terminal to the computer initiates 
the login process. The operating system, either 
NOS or NOS/BE, identifies itself to you, and you 
must supply information that indicates you are a 
valid system user. 



LOGGING IN UNDER NOS 

The login procedure to NOS begins with initial 
information from the system (including date, time, 
terminal name, installation name, and operating 
system version) . The second line of this informa- 
tion is dependent on the installation. You are 
then prompted to enter information to indicate you 
are a valid system user. The prompts and required 
responses are as follows: 

FAMILY: 



PASSWORD: 

Enter the 4- to 7-character password 
assigned to you to provide access security; 
some terminals overtype to preserve privacy. 

temraam- APPLICATION : 

Enter IAF (for Interactive Facility, the 
network software that provides you with the 
time-sharing capabilities of NOS); termnam 
represents the terminal identification. 

JSN: zzzz, NAMIAF 
CHARGE NUMBER: 
or 

JSN: zzzz, NAMIAF 
READY. 

If a charge number is requested, enter your 
assigned charge number and project number. 
The system will then respond with READY. 
The login procedure is now complete. You 
can then enter the batch subsystem. Do not 
change to ASCII mode since Sort/Merge does 
not process data in this mode. 

Figure 4-1 shows an example of a NOS login. You 
are now ready to perform sort or merge operations 
as described later in this section. 



82/01/08. 10.42.16. T143A 

CDC NOS 2 

FAMILY: 

USER NAME: xxxxxxx 

PASSWORD: xxxx 

T143A - APPLICATION: iaf 

JSN: AADI, NAMIAF 

CHARGE NUMBER: 
? WtX&MXX 

PROJECT NUMBER: 

READY, 
/batch 
RFL,0. 
/ 



Figure 4-1. NOS Login Example 



Enter the family name of the mass storage 
device that contains your permanent files. 
Some installations do not request a family 
name; the family name is the default family 
for the system. 



USER NAME: 



Enter the user name assigned to you by your 
system administrator. 



LOGGING IN UNDER NOS/BE 

As soon as your terminal is connected to the 
system, the system responds with a message indi- 
cating date, time, and the INTERCOM version number 
(INTERCOM is the software that directs the flow of 
data between your terminal and the central site 
computer). The system requests the following: 

PLEASE LOGIN 
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Enter LOGIN. You are then prompted for validation 
information. The prompts and required responses 
are as follows: 

ENTER USER NAME- 

Enter the user name assigned to you by your 

system administrator. 

mSSBQXX ENTER PASSWORD- 

Enter the password (up to 10 letters and 
digits) assigned to you to provide access 
security; some terminals overtype to pre- 
serve privacy. 

When the user number and password are accepted, a 
2-character user code and the login time, followed 
by the equipment number and port number, are dis- 
played or printed at your terminal. The message 
COMMAND- appears, indicating the login process is 
complete. Figure 4-2 shows an example of NOS/BE 
login. You are now ready to perform sort or merge 
operations as described in the following subsection. 



INTERACTIVE DIALOG 

Sort/Merge provides an interactive dialog to aid in 
specifying parameters. The tutorial dialog is 
designed to guide you, step by step, through your 
sort or merge specification. You can specify any 
control statement sort or merge, including a sort 
or merge with owncode routines and a nonstandard 
collating sequence, using the interactive dialog. 

After login is complete, and before beginning the 
dialog, you must assign any files used in your sort 
or merge (files containing input records to be 
sorted, owncode routines, or presorted files to be 
merged) to your terminal with an ATTACH command or 
the equivalent. You must enter CYBER Record Man- 
ager (CRM) FILE control statements for any of your 
files that are not written in standard unit record 
format. Standard unit record format files include 
files created by punched cards in a batch job or 
lines entered at a terminal, and the special files 
INPUT, OUTPUT, and PUNCH. CRM defines these files 
as block type C (BT=C) and record type Z (RT=Z). 
Sort/Merge assumes each record contains 150 char- 



acters or less. If you have any files of consider- 
ably less than 150 characters (25 characters for 
example), Sort/Merge can perform more efficiently 
if you enter a FILE control statement. See your 
operating system reference manual for information 
about retrieving permanent files and the CRM Basic 
Access Methods reference manual for information 
about FILE control statements. 

For NOS/BE users, Sort/Merge automatically connects 
and disconnects files INPUT and OUTPUT; Sort/Merge 
writes the dialog to OUTPUT, which is displayed or 
printed at your terminal. Your dialog responses 
are read from INPUT. 

The interactive dialog begins when you type 
S0RT5.DIAL0G=YES or MERGE . DIAL0G=YES . Any other 
parameters (except STATUS) that you enter along 
with DIALOG are ignored. During the dialog, Sort/ 
Merge asks various questions, one at a time, and 
your response to each question determines the next 
question. For example, Sort/Merge asks if you have 
just one input file and no 0WN1 or 0HN2 subrou- 
tines. If you enter YES, the next question 
requests the name of your input file. If you enter 
NO, the next question asks if you have an 0WN1 
subroutine . 

The expected response to each question is evident 
from the question. For example, one question asks 
how many key fields you have; you enter a number. 
For questions requiring yes or no answers, you can 
type YES or Y, or NO or N. If you make a mistake 
(misspell the word yes, for example), Sort/Merge 
gives you an explanation of the expected answer and 
asks the question again. If you enter an incorrect 
answer a second time, Sort/Merge asks you if you 
want help. If you type YES, an explanation of 
Sort/Merge usage is displayed or printed at your 
terminal. If you do not want help and type NO, the 
original question iB repeated. Figure 4-3 shows an 
example of this sequence. 

The last question Sort/Merge asks is how many 
records are to be sorted or merged. After you 
enter the appropriate number, Sort/Merge informs 
you that the sort or merge you have specified is 
beginning. When the sort or merge is complete, 
control of your terminal is returned to the oper- 
ating system; the operating system prompt for input 
appears (/ under NOS, COMMAND- under NOS/BE). 



CONTROL DATA INTERCOM 5.0 
DATE 01/23/81 
TIME 09.35.50. 






PLEASE LOGIN 






login 

ENTER USER NAME-sort 

MHMBHNHORf ENTER PASSW0RD- 






01/23/81 LOGGED IN AT 09.36 
WITH USER-ID OK 
EQUIP/PORT 63/076 


.23. 




LOGIN CREATED 01/21/81 


TODAY 


IS 01/23/81 


C0MMAND- 







Figure 4-2. NOS/BE Login Example 



4-2 



60484800 B 



/sort5.dialog=yes -*- 



Begin interactive dialog. 



ARE YOU SURE THAT ALL YOUR FILES (IF ANY) ARE EITHER 

STANDARD UNIT RECORD FORMAT OR HAVE HAD FILE CONTROL 

STATEMENTS SPECIFIED FOR THEM 
? yes 

DO YOU HAVE JUST ONE INPUT FILE AND NO OWN1 OR 0WN2 SUBROUTINES 
? no 

DO YOU HAVE AN OWN1 SUBROUTINE 
? yse — — — Incorrect response. 

do you have an OWN1 subroutine -. Question asked again. 

? yse — — Second incorrect response. 

DO YOU WANT HELP 

? y 
SINCE YOU did not SAY "NO" YOU ARE GOING TO be helped. -». Help after second incorrect response. 
■Y' IS THE SAME AS 'YES' AND 'N' IS THE SAME AS 'NO'. 
TYPE 'RESTART' TO GO BACK TO THE BEGINNING. 
TYPE 'QUIT' TO STOP RUN. 

THE OWN1 ROUTINE CAN BE USED TO PROCESS INPUT RECORDS. A DETAILED DESCRIPTION 
OF THIS OUNCODE ROUTINE IS IN THE SORT/MERGE REFERENCE MANUAL. 

DO YOU HAVE an OWN1 subroutine — Question asked again. 

? yse 

DO YOU HAVE AN OWN1 SUBROUTINE 
? yse 

DO YOU WANT HELP 
? no 

do you have AN OWN1 subroutine — No help after second incorrect 

? yes response; question asked again. 



Figure 4-3. Incorrect Response Example 



If sorted or merged records are written to a file 
(not processed by an owncode routine), Sort/Merge 
creates a local file and gives this file the name 
you entered in response to the question "What is 
the name of your output file?" Upon completion of 
the sort or merge, you can display or print this 
file at your terminal, or route the file to a 
printer to be listed. If you want to use the file 
at a later time, you must save it as a permanent 
file before logging out; otherwise, the file Is 
lost. Figure 4-4 shows an example of output file 
disposition. 



After the explanation, the question Sort/Merge 
asked you immediately before you entered the HELP 
command is asked again, resuming the dialog. 



RESTART 

If you type RESTART, the interactive dialog is 
started over at the beginning. All previous 
answers to questions are discarded. You can use 
this command if you give Sort/Merge incorrect 
information such as the wrong number of key fields. 



INTERACTIVE COMMANDS 

Several commands exist to control the use of the 
interactive dialog. These commands are HELP, 
RESTART, and QUIT. A command can be entered at any 
time during the dialog, but HELP, RESTART, and QUIT 
cannot be the names of user-supplied entitles such 
as files and collating sequences. Use of the 
comnands is described in the following paragraphs. 



HELP 

If you type HELP, an explanation of Sort/Merge 
usage is displayed or printed at your terminal. 



QUIT 

If you type QUIT, the interactive dialog is ter- 
minated. The sort or merge is not performed, and 
control of your terminal is returned to the oper- 
ating system. You can then perform other terminal 
operations or logout. If permanent files con- 
taining input records to be sorted or merged, or 
owncode routines have been assigned to your Job, 
you should release these files by using the RETURN 
command (see your operating system reference 
manual). 

Figure 4-5 shows an example of interactive command 
use. 
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/sort5. dialog=yes -*. 



WHAT IS THE NAME OF YOUR OUTPUT FILE 
? srtout -« 



THANK YOU SORT/MERGE NOW BEGINS. 
SORT5.dialog=YES -« 



/copysbf, srtout, output -• 

1REYES S L 10fJ246031558ANTHR0 3341 

MAYER M I 100991122359ANTHRO 2882 

CHARLES S H 101 41 8032459ANTHRO 2453 
MARTIN R C 100955032157ART 2891 

NEECE M L 99911121358ART 2291 



LASEUR P T 

SUGARMAN B T 

SMITH F R 

DOUGLAS M L 

OKADA N A 

EOI ENCOUNTERED, 
/rewi nd, srtout 
REWIND, SRTOUT. 
/copysbf, srtout ,myf i I 

EOI ENCOUNTERED, 
/route, myf i t,dc=pr -*- 

ROUTE COMPLETE, 
/save, srtout — 



100678042256PSYCH 2233 

10O528O70457S0C 3501 

101062120758SOC 2913 

101325071558UNDEC 2585 

100103111750UNDEC 2225 



Begin interactive dialog. 



Local file created for sorted output. 



Dialog completion; sort begins. 

NOS repeats control statement (up to 48 characters). 

Display or print sorted file. 



File SRTOUT. 



Copy sorted file to be listed by printer. 
Route copy of sorted file to printer. 
Make sorted file a permanent file. 



Figure 4-4. Output File Disposition Example 



/sort5.dialog=yes -»- 



ARE YOU SURE THAT ALL YOUR FILES (IF ANY) ARE EITHER 
STANDARD UNIT RECORD FORMAT OR HAVE HAD FILE CONTROL 
STATEMENTS SPECIFIED FOR THEM 

? y 

DO YOU HAVE JUST ONE INPUT FILE AND NO 0WN1 OR OWN2 SUBROUTINES 
? n 

DO YOU HAVE AN OWN1 SUBROUTINE 
? y 

WHAT IS THE NAME OF THE FILE CONTAINING YOUR OWNCODE SUBROUTINE (S) 
? myrtns-^ — — — 



Begin interactive dialog. 



WHAT IS THE NAME OF YOUR OWN1 SUBROUTINE 
? restart 
IN RESPONSE TO YOUR REQUEST RESTART HAS BEEN INITIATED. 
ARE YOU SURE THAT ALL YOUR FILES (IF ANY) ARE EITHER -*- 
STANDARD UNIT RECORD FORMAT OR HAVE HAD FILE CONTROL 
STATEMENTS SPECIFIED FOR THEM 

? y 



Command entered. 



Dialog started over 
at beginning. 



DO YOU HAVE JUST ONE INPUT FILE AND NO 0WN1 OR 0WN2 SUBROUTINES 
? n 
DO YOU HAVE AN 0WN1 SUBROUTINE 

i y 

WHAT IS THE NAME OF THE FILE CONTAINING YOUR OWNCODE SUBROUTINE (S) 
? ownsrtn 

WHAT IS THE NAME OF YOUR 0WN1 SUBROUTINE 
? myrtn 

DO YOU HAVE AN 0WN2 SUBROUTINE 
? help — 

'Y' IS THE SAME AS 'YES' AND *N' IS THE SAME AS 'NO'. 

TYPE 'RESTART' TO GO BACK TO THE BEGINNING. 

TYPE 'SUIT' TO STOP RUN. 

THE 0WN2 ROUTINE CAN BE USED TO PROCESS INPUT FILES. A DETAILED DESCRIPTION 

OF THIS OWNCODE ROUTINE IS IN THE SORT/MERGE REFERENCE MANUAL. 

DO YOU HAVE AN 0WN2 SUBROUTINE 
? quit -*- — — Command entered. 

sort/merge is quitting. — Sort/Merge terminated 



Command entered. 



Usage 
explanation. 



Figure 4-5. Interactive Command Example 
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SPECIFYING PARAMETERS 
INTERACTIVELY 

You can specify any of the Sort/Merge parameters 
from your terminal in a S0RT5 or MERGE control 
statement. After you login, assign all necessary 
files (including directive files) to your job, and 
type in FILE control statements for files with 
other than default characteristics. You enter 
SORT 5 or MERGE followed by parameters in one of the 
following forms: 

S0RT5.pl ,p2 pn 

MERGE. plA p2 A . . . A pn 

In the preceding example, p represents a processing 
parameter. Parameters must be separated by commas 



or spaces; commas and spaces can be used inter- 
changeably. You can enter the control statement 
and parameters in input line character positions 1 
through 80. If your sort or merge specification is 
longer than 80 characters, you must use a directive 
file for the additional parameters. 

Figure 4-6 shows an example of specifying param- 
eters interactively. 



LOGGING OUT 

To end your terminal session, you type GOODBYE, 
BYE, or LOGOUT If you are using the Interactive 
Facility of NOS. If you are using INTERCOM under 
NOS/BE, you type LOGOUT. Under either system, a 
message indicating that you are logged out is dis- 
played or printed at your terminal. 



/attach, univer -" 

/fi le(univer,bt=c,rt=z,f 1=38)1 
FILE(UNIVER,BT=C,RT=Z,FL=38) < 
/file(oout,bt=c,rt=z,f 1=38) 1 
FILE(00UT,BT=C,RT=Z,FL=38) ' 

/sortS.f rom=univer,to=oout,key=((35,3,ascii6,d) ) 
S0RT5.FR0M=UNIVER,T0=00UT,KEY=( (35,3, ASC 116,0)) 
/■•— . ___ 



Input file assigned to the job. 



— FILE control statements for input 
and output files because records 
are only 35 characters in length. 

S0RT5 control statement entered. 

NOS repeats control statement 

(up to 48 characters). 

Control returns to NOS operating system. 



Figure 4-6. Interactive Parameter Specification Example 
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PROCEDURE CALLS 



Sort/Herge also exists as a set of procedures; a 
sort or merge can be invoked from within a program 
by a sequence of procedure calls. The procedures 
can be called from FORTRAN or by a program in any 
language that uses the standard FORTRAN calling 
sequence. The same type of Sort/Merge processing 
is available through the procedures as is available 
through the SORTS or the MERGE control statement; 
the procedure calls closely correspond to the 
Sort/Herge parameters. This section describes the 
procedure calls; COBOL programmers should see 
section 6 for information on calling the procedures. 

All conventions for coding FORTRAN statements must 
be observed in procedure calls (see the FORTRAN 5 
reference manual) . You must assign any permanent 
files named in procedure calls to your job with an 
ATTACH command (or the equivalent) in the control 
statement section of the job. The procedures 
cannot be used in a static memory management 
environment . A merge could require twice as much 
mass storage for intermediate merge files as is 
required for the merge input files. 

All files to be sorted, or presorted files to be 
merged, must be sequential files. The default file 
characteristics are block type C, record type Z, 
and full length of 150 characters or less. For 
files with other block types and record types , you 
must include CYBER Record Manager (CRM) FILE 
control statements in the control statement section 
of your job. See the CRM Basic Access Methods 
reference manual for information on block types and 
record types. 

The procedures can be called in any order with two 
exceptions: SM5S0RT or SM5MERC must be the first 
procedure called, and SM5END must be the last 
procedure called. Sort/Merge collects processing 
information until SM5END is called; the sort or 
merge is then performed. Unless stated otherwise, 
a procedure can be called only once during a sort 
or merge. Refer to section 7 for information on 
owncode routines , which are mentioned in the 
descriptions of several of the procedures. 



SM5SORT 

Execution of the SM5S0RT procedure signals the 
beginning of a sort specification. The SM5S0RT 
procedure must be the first procedure called for a 
sort. The format of the SM5S0RT call is shown in 
figure 5-1. 



CALL SM5SORT(option) 

option Result array name (1 to 7 letters or digits, 

beginning with a letter) or the integer 0. 



statistics and results to your program when the 
sort is completed. You set the first element of 
the result array to the number of elements (as many 
as 15) in which you want to receive information. 
If you set the first element to or specify CALL 
SM5S0RT(0), no statistics or results are returned. 
The type of result that is returned in each element 
is shown in table 5-1. 



TABLE 5-1. RESULT ARRAY FORMAT 



Figure 5-1. SM5SORT Format 

The array associated with the SM5S0RT procedure is 
a 16- element integer array that returns sort 



Array 
Element 
Number 


Contents 


I 


Number of elements of results 
you want returned (0 through 
15) 


2 


Number of records read from 
sort or merge input files 


3 


Number of records deleted by 
an owncode 1 routine 


4 


Number of records inserted by 
an owncode 1 routine 


5 


Number of records inserted by 
an owncode 2 routine 


6 


Number of records sorted or 
merged 


7 


Number of records deleted by 
an owncode 3 routine 


8 


Number of records inserted by 
an owncode 3 routine 


9 


Number of records inserted by 
an owncode 4 routine 


10 


Reserved 


11 


Number of records deleted by 
an owncode 5 routine 


12 


Number of records combined by 
summing 


13 


Number of records written to 
output file 


14 


Minimum record length in 
characters 


15 


Average record length in 
characters 


16 


Maximum record length in 
characters 
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SM5MERG 

Execution of the SM5MERG procedure signals the 
beginning of a merge specification. The SM5MERG 
procedure must be the first procedure called for a 
merge. The format of the SM5MERG call is shown in 
figure 5-2. 



owncode routine supplies records). 
SM5FR0M file results in a null sort. 



An empty 



CALL SM5MERG(option) 

option Result array name (1 to 7 letters or digits, 

beginning with a letter) or the integer 0. 



Figure 5-2. SM5MERG Format 

The input files for a merge must be presorted. 
Input files for a merge with summing must be 
presorted and presummed. 

The array asociated with the SM5MKRG procedure is a 
16-element integer array that returns merge statis- 
tics and results to your program when the merge is 
completed. You set the first element of the result 
array to the number of elements (as many as 15) in 
which you want to receive information. If you set 
the first element to or specify CALL SM5MERG(0), 
no statistics or results are returned. The type of 
result that is returned in each element is shown in 
table 5-1. Note that the array is not set by Sort/ 
Merge until the end of the merge. 



SM5FROM 

Execution of the SM5FR0M procedure specifies the 
input files from which the records to be sorted or 
merged are read. The format of the SM5FR0M call is 
shown in figure 5-3. 



CALL SMSFROMCfilel'L'file?] 



'file' 



File name; 1 to 7 letters or digits, beginning 
with a letter. 



Figure 5-3. SMSFROM Format 

You can specify as many as 100 files with one 
SM5FR0M procedure, or you can call the SM5FR0M 
procedure as many as 100 times. The files are read 
in the order that you specify them. The files are 
rewound before and after use unless the name of the 
file is INPUT or a FILE control statement parameter 
specifies otherwise. 

Sort/Merge assumes that the files you specify with 
the SM5FR0M procedure are CRM block type C and 
record type Z with FL of 150 characters or less. 
If you specify files that have different character- 
istics, you must describe these files to Sort/Merge 
by including FILE control statements in the control 
statement section of your job. The files are not 
read past embedded end-of-record or end-of-file 
marks (see the CRM Basic Access Methods reference 
manual ) . 

If the SM5FR0M procedure is not called, records to 
be sorted are read from the file OLD (unless an 



SM5TO 

Execution of the SM5TO procedure specifies the file 
to which sorted or merged records are written (if 
records are left after owncode routine processing). 
The format of the SM5T0 call is shown in figure 5-4. 



CALL SM5TO('file') 



'file' 



File name; 1 to 7 letters or digits, beginning 
with a letter. 



Figure 5-4. SM5TO Format 

The file is not rewound before or after use unless 
the name of the file is OUTPUT or a FILE control 
statement parameter specifies otherwise. Sort/ 
Merge assumes that the file you specify with the 
SM5T0 procedure is CRM block type C and record type 
Z with FL of 150 characters or less. If you 
specify a file with different characteristics, you 
must describe the file to Sort/Merge by including a 
FILE control statement in the control statement 
section of your job. 

Sort/Merge writes the file directly, and the file 
is closed when the sort or merge is completed 
unless the name of the file is INPUT. If your 
program also reads or writes the file, you must 
include an OPEN or REWIND statement in your program 
after calling the procedures. If the SM5T0 
procedure is not called, records are written to the 
file NEW (unless an owncode routine processes all 
records). 



SM5KEY 

Execution of the SM5KEY procedure specifies a 
single key field for the sort or merge. The format 
of the SM5KEY call is shown in figure 5-5. 



CALLSM5KEY(first,length. , type , ,'ad') 

first First byte or bit of the key field. 

length Number of bytes or bits in the key field. 

'type' Name of a numeric data format or collating 

sequence. 

'ad' Order, either 'A' for ascending or 'D' for 

descending. 



Figure 5-5. SM5KEY Format 

In the SM5KEY procedure call, you specify the first 
byte or bit of the key field, the length of the 
field in bytes or bits, the key type (the name of a 
collating sequence or a numeric data format), and 
the sort order. You must specify the key charac- 
teristics in the order shown. 
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You specify first and length as integers; the 
leftmost byte or bit in a record is counted as 
number 1. For character data, each character is 
six bits and occupies one byte. For numeric data, 
first and length refer to bytes except for formats 
BINARY_BITS and INTEGERJBITS . You must specify the 
first byte or bit of a key field. If you do not 
specify the length, length defaults to 1. 

The key type is the name of a predefined collating 
sequence or your own collating sequence defined by 
SM5SEQx procedures , or the name of a numeric data 
format. The name must be enclosed in apostrophes. 
The default type is the ASCII6 collating sequence. 
See section 2 for a list of predefined collating 
sequences and numeric data formats. 

The sort order is either ascending or descending, 
and you specify 'A' or 'D', respectively. The 
default order is ascending. For numeric keys 
sorted in ascending order, the record having the 
key with the highest value is written last on the 
output file. Ascending character keys are sorted 
according to the collating sequence you specify. 
For numeric keys sorted in descending order, the 
record having the key with the lowest value is 
written last on the output file. Descending 
character keys are sorted in reverse order of the 
collating sequence you specify. 

You can call the SM5KEY procedure as many as 100 
times during a sort or merge to specify multiple 
sort keys. Output records are sorted or merged 
according to the key field described by the first 
SMSKEY procedure called, then according to the key 
field described by the second SH5KEY procedure 
called, and so on. The total number of key 
characters must be less than 256 (if you also 
specify sum fields, the total number of characters 
in the key and sum fields together must be less 
than 256). Key fields cannot overlap one another. 
If the SM5KEY procedure is not called, the entire 
record is used as a character key field, and the 
default key type and sort order are used. 



SM5EL 

Execution of the SM5EL procedure specifies the 
error level to be reported. The format of the 
SM5EL call is shown in figure 5-7. 



CALL SM5EL(error-level) 

error-level Alphabetic character enclosed in apostrophes 
or integer (see table 5-2). 



Figure 5-7. SM5EL Format 

The error levels that you can select are shown in 
table 5-2. You can specify the alphabetic charac- 
ter enclosed in apostrophes or the integer. For 
example if you specify 'W or 2, any warning, 
fatal, and catastrophic error messages are re- 
ported. Errors are written to the file specified 
by the SM5E procedure or, if the SM5E procedure is 
not called, to the file OUTPUT. If the SM5EL 
procedure is not called, errors of levels T, W, F, 
and C are reported. See appendix B for an explana- 
tion of the four levels of errors. 

TABLE 5-2. ERROR LEVEL SPECIFICATION 



Error Level 


Errors Reported 


'T' or 1 
'W or 2 
'F' or 3 
'C or 4 


T, W, F, C 
W, F, C 
F, C 
C 



SM5E 

Execution of the SM5E procedure specifies the file 
to which diagnostic messages are written. The 
format of the SM5E call is shown in figure 5-6. 



CALL SM5E('file') 



'file' 



File name; 1 to 7 letters or digits, beginning 
with a letter. 



Figure 5-6. SM5E Format 

The file is written in CRM BT=C, RT=Z, and FL=72 
format. The file is not rewound before or after 
use unless a FILE control statement parameter 
specifies rewind. If the SM5E procedure is not 
called, diagnostic messages are written to the file 
OUTPUT. If you specify the file $NULL with the 
SM5E procedure, diagnostic messages are not written. 



SM5ENR 

Execution of the SM5ENR procedure specifies the 
estimated number of records to be sorted or 
merged. The format of the SM5ENR call is shown in 
figure 5-8. 



CALL SM5ENR(integer) 
integer 



Number of records to be sorted or merged; 
to 1000000000. 



Figure 5-8. SM5ENR Format 

The integer you specify is the approximate number 
of records to be sorted or merged. If SM5ENR is 
specified as less than 1500, Sort/Merge uses less 
memory for the initial sort phase. This causes 
noticeably less memory required for the entire sort 
if the actual number of records is a low number. 
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SM5FAST 

Execution of the SM5FAST procedure can specify that 
certain sort input and output records are to be 
read and written directly by Sort/Merge rather than 
by means of CYBER Record Manager (CRM). The 
SM5FAST procedure is ignored during a merge. The 
format of the SM5FAST call is shown in figure 5-9. 



CALL SM5FAST(option) 
option 



'YES' or 'Y' 
INO 'or 'N' 



Figure 5-9. SM5FAST Format 

The option can be 'YES' or 'NO' (or 'Y' or 'N'). 
If the option is 'YES', certain sort or merge input 
and output records are read and written directly by 
Sort/Merge. If the option is 'NO', CRM is used. 



Files processed by the SM5FAST procedure must 
reside on mass storage. The records in these files 
must be block type C and record type F, or block 
type I and record type W (see the CRM Basic Access 
Methods reference manual for detailed infor- 
mation). All input files must have an identical 
record type and record length. If the file resides 
on tape, or if the records are not all the same 
type and length, a warning diagnostic is issued and 
the SM5FAST option is canceled. The files are then 
processed using CRM. Sort/Merge obtains block and 
record type information from the file information 
table (FIT) ; a FILE control statement is not 
ignored. Calling the SM5FAST procedure with 'YES' 
results in increased speed, but not all errors are 
diagnosed; use this proce- dure when you are sure 
your files are correctly written and described. 



SM50FL 

Execution of the SM50FL procedure specifies the 
number of characters in fixed length records 
entering the sort from an owncode routine. The 
format of the SM50FL call is shown in figure 5-10. 



CALL SM50FL(integer) 



Figure 5-10. SM50FL Format 

The integer you specify is the exact number of 
characters in each record; a catastrophic error 
results if a record entering the sort from an 
owncode routine does not have the exact number of 
characters. If the SM50FL procedure is not called, 
records entering the sort from an owncode routine 
can be no longer than the longest allowed input or 
output record. You cannot call both the SM50FL 
procedure and the SM50MRL procedure in the same 
sort. 



SM50MRL 

Execution of the SM50MRL procedure specifies the 
maximum length of any record entering the sort from 
an owncode routine. The format of the SM50MRL call 
is shown in figure 5-11. 



CALL SM50MRL(integer) 



Figure 5-11. SM50MRL Format 

The integer you specify is the maximum record 
length in characters. (The SM50FL procedure is 
recommended if all records entering the sort from 
an owncode routine are the same length.) The 
SM50MRL procedure need not be called if the sort 
has an input or output file with a maximum record 
length at least as long as the record length 
specified by this procedure. If the SM50MRL 
procedure is not called, records entering the sort 
from an owncode routine can be no longer than the 
longest allowed input or output record. You cannot 
call both the SM50MRL procedure and the SM50FL 
procedure in the same sort. 



SM50WNn 

Execution of the SM50WNn procedure specifies an 
owncode routine that is executed each time a 
certain point is reached during the sort or merge. 
The format of the SMSOWNn call is shown in figure 
5-12. 



CALL 


SM50WNn(proc) 










n 


1, 2, 3, 4, or 5 










proc 


Owncode routine 
beginning with a 


name; 
letter. 


1 to 7 letters 


or 


digits. 



Figure 5-12. SM50WNn Format 

The procedure you specify is the name (address) of 
the owncode routine; in a FORTRAN program, the name 
must be declared in an EXTERNAL statement. The n 
associated with the SM50WNn call must be 1, 2, 3, 
4, or 5. If the SM50HNn procedure is not called, 
no owncode routine is executed. 



SM5RETA 

Execution of the SM5RETA procedure can specify that 
records with equal sort keys are output in the same 
order as they are input. The format of the SM5RETA 
call is shown in figure 5-13. 



CALL SM5RETA(option) 



option 



'YES' or V 
'NO' or 'N' 



Figure 5-13. SM5RETA Format 
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The option can be 'YES' or 'NO' (or 'Y' or 'N'). 
If the option is 'YES', records with equal keys 
retain their original order. If the option is 
'NO', records with equal keys might not retain 
their original order. 

If RETAIN=YES and you specify more than one sort or 
merge input file with the SM5FROM procedure, the 
order in which you specify the input files is the 
order in which records with equal keys are output. 
If the SM5RETA procedure is not called, records 
with equal keys might not be output in the same 
order as they are input. 

You cannot specify both the SM5RETA parameter and 
the SM5SUM parameter in the same sort or merge. If 
you do specify both, a catastrophic error occurs. 



SM5SEQx 

Execution of a series of SM5SEQx procedures 
specifies a user-defined collating sequence that is 
referenced by the SM5KEY procedure. The formats of 
the SM5SEQx calls are shown in figure 5-14. 



CALL SM5SEQN('name') 

CALL SM5SEQS('char' "char") 



[CALL SM5SEQRCYES') or CALL SM5SEQR('Y') 
[CALL SM5SEQACYES') or CALL SM5SEQA('Y') 



name 



'char' 



Collating sequence name; 1 to 31 letters, 
digits, or the special characters ? # @ — . 
Only 10 characters are significant and the 
first must be a letter. 

Character in the collating sequence. 



Figure 5-14. SMSSEQx Formats 

The SM5SEQN procedure names your collating 
sequence. The name is a literal enclosed in 
apostrophes; the name cannot be the same as the 
name of one of the predefined collating sequences. 
The SM5SEQN procedure must be the first called in 
the series of SM5SEQx procedures. 

Collating positions are assigned to the characters 
in your collating sequence by the SM5SEQS 
procedure, which can be called more than once. 
Each SM5SEQS procedure specifies a value step in 
the sequence. A value step consists of one or more 
characters, and characters specified in the same 
step collate equally. Characters specified with 
the first SM5SEQS procedure called collate first, 
characters specified with the second SM5SEQS 
procedure called collate second, and so on. The 
following paragraphs describe how to specify steps 
in your collating sequence with SM5SEQS procedures. 

You can specify a value step consisting of one 
character by a graphic character (see appendix A) 
enclosed in apostrophes as in the following example: 

CALL SM5SEQSCA') 

You can specify a value step consisting of several 
characters by single characters enclosed in 



apostrophes and separated by commas. The following 
example specifies a step consisting of the blank 
and the digits 0, 1, 2, and 3, all of which collate 
equally : 

CALL SM5SEQSC ' ,'0' ,'1' ,'2','3') 

If the SM5SEQR procedure is called, equal collating 
position is assigned to any characters not 
specified by SM5SEQS procedures. For example, if 
you define a collating sequence that includes 
digits and letters but not any of the special 
characters (such as commas, periods, slashes), a 
call to SM5SEQR includes the special characters in 
your collating sequence. The special characters 
all collate equally. The SM5SEQR procedure can 
only be called once for each call to SM5SEQN; the 
SM5SEQR procedure can be called anywhere in the 
SM5SEQx series. 

If the SM5SEQA procedure is called, characters in 
the same value step are altered on output to the 
first character in the step. The following example 
alters all asterisks and ampersands to slashes: 

CALL SM5SEQSC/', '*','&') 
CALL SM5SEQA('YES') 

The SM5SEQA procedure can only be called once for 
each call to SM5SEQN; the SM5SEQA procedure can be 
called anywhere in the SMSSEQx series. 

Your collating sequence specification is terminated 
by any procedure call other than SM5SEQS, SH5SEQR, 
or SM5SEQA. You can define more than one collating 
sequence by calling a separate series of SM5SEQx 
procedures for each collating sequence. The name 
of each collating sequence must be unique. If no 
SMSSEQx procedures are called, a nonstandard 
collating sequence is not defined. 



SM5ST 

Execution of the SM5ST procedure specifies an 
integer variable that is set to a value represent- 
ing the highest level of error that occurred during 
the sort or merge. The format of the SM5ST call is 
shown in figure 5-15. 



CALL SM5ST{variable) 

variable Symbolic name of an integer variable; 1 to 

7 letters or digits, beginning with a letter. 



Figure 5-15. SM5ST Format 

The error level that is represented by the value 
returned to the SM5ST procedure is shown in table 
5-3. For example if a 3 is returned to the SM5ST 
procedure, a fatal error occurred during the sort 
or merge. If you call the SM5ST procedure, 
Sort/Merge does not abort if a catastrophic error 
occurs before any data records are input. However, 
if Sort/Merge calls another product and an 
unrecoverable error results, an abnormal job 
termination will occur. For example, if Sort/Merge 
calls a product, such as Common Memory Manager 
(CMH), and CMM processing results in an error, a 
termination will occur. 
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TABLE 5-3. ERROR LEVEL CODES, SM5ST CALL 



Error Level 


Code 


No errors 





Trivial 


10 


Warning 


20 


Fatal 


30 


Catastrophic 


40 



SM5SUM 

Execution of the SM5SUM procedure specifies fields 
that are to be summed in records with equal key 
values . Input files for a merge with summing must 
be presorted and presummed. As many as 255 bytes 
can be summed. The records with all key fields 
equal are combined into one new record, and the 
other records with equal keys are deleted. The one 
resultant record contains the key fields and the 
fields that are the sums of the specified fields 
from all the records with equal keys; a data field 
that is not a key field or a sum field is set to 
the corresponding field from one of the old 
records. The format of the SM5SUM call is shown in 
figure 5-16. 



CALL SM5SUM(first,length,'type',rep) 

first First byte or bit of the sum field. 

length Number of bytes or bits in the sum field. 

'type' Name of a numeric data format. 

rep Number of fields to be summed. 



Figure 5-16. SM5SUM Format 



All the fields to be summed must contain numeric 
data; otherwise, the contents of the new field are 
undefined. The fields described as sum fields 
cannot also be key fields. 

The SM5SUM procedure call specifies the first byte 
or bit of the sum field, the length of the sum 
field in bytes or bits, the type of data in the sum 
field (the name of a numeric data format except 
REAL), and the number of fields to be summed. See 
section 2 for a list of numeric data formats. 



If you specify multiple fields with one SM5SUM 
procedure, the fields must be consecutive, be the 
same length, and contain the same type of numeric 
data. Sum fields cannot overlap one another. If a 
sum field contains no data because a record is 
short, the sum for that field is undefined. 

Figure 5-17 shows an example of an SM5SUM procedure 
call. Part A of figure 5-17 shows the layout of 
the record containing fields to be summed. Part B 
shows three SM5SUM procedure calls, each describing 
one field to be summed. Part C shows one equiva- 
lent SM5SUM procedure call that describes the three 
consecutive fields to be summed. 



If the summing of the specified fields results in 
new numeric values that do not fit into the sum 
fields, a fatal error results. One of the records 
that caused the overflow is deleted as usual, but 
the sum field contents in the remaining record are 
undefined. A diagnostic message indicating which 
field caused the overflow is issued, and the job is 
terminated at the end of the sort (unless you call 
the SM5ST procedure). 

You can call the SM5SUM procedure as many as 100 
times during a sort or merge to specify different 
sum fields. If the SM5SUM procedure is not called, 
records with equal key values are not automatically 
combined into single records. You cannot call both 
the SH5SUH procedure and the SM50WN5 procedure in 
the same sort or merge. 

You cannot specify both the SM5RETA and the SM5SUM 
procedure in the same sort or merge. If you do 
specify both, a catastrophic error occurs. 



A. Record Layout 



10 



15 



20 



25 



Student number 
(sort key) 



Number of 
units registered 



Number of 
units completed 



Grade points 



B. SM5SUM Procedure Calls 

CALL SM5SUM(11,5. 'INTEGER', 1) 
CALL SM5SUM(16,5,'INTEGER',D 
CALL SM5SUM(21,5, 'INTEGER', 1) 

C. SM5SUM Procedure Call 



CALL SM5SUM(11,5, 'INTEGER', 3) 



Figure 5-17. SM5SUM Procedure Call Example 
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SM5END 



Execution of the SM5END procedure terminates your 
sort or merge specification and initiates Sort/ 
Merge processing. The format of the SM5END call is 
shown in figure 5-18. The SH5END procedure must be 
the last called for any one sort or merge. 



CALL SM5END 



Figure 5-18. SM5END Format 
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COBOL INTERFACE 



Two options are available for using Sort/Merge 5 
from COBOL 5: a control statement option when you 
use the COBOL SORT or MERGE statement and direct 
calls. This section describes these two options. 



COBOL5 CONTROL STATEMENT 
OPTION 

Sort /Merge is used by COBOL when the COBOL SORT or 
MERGE statement is included in your program. You 
can select Sort /Merge 5 by means of a C0B0L5 
control statement option. If you specify S0RT5 in 
your C0B0L5 control statement, Sort/Merge 5 is used 
when the SORT or MERGE statement in your program 
executes. Figure 6-1 shows a sample C0B0L5 control 
statement that includes the S0RT5 option. See the 
COBOL 5 reference manual for information on coding 
the SORT or MERGE statement in a program. 



COBOL5,l=PROGA,SORT5,L=REPTO. 



Figure 6-1. COBOL5 Control Statement 
Example 



DIRECT CALLS 



Direct calls from a COBOL 5 program to the Sort/ 
Merge procedures described in section 5 can be made 
with ENTER FTN5 SMSxxx statements. Calls to the 
procedures cannot be mixed with the SORT or MERGE 
statement; the procedures cannot be called in a 
COBOL input or output procedure, and the SORT or 
MERGE statement cannot be executed in a series of 
direct calls (before SM5END is called). See the 
COBOL 5 reference manual for information on coding 
ENTER statements. 



All files to be sorted or merged must be sequential 
files. The default file characteristics are block 
type C, record type Z, and full length of 150 
characters or less. For files with other block 
types and record types, you must include CYBER 
Record Manager (CRM) FILE control statements in the 
control statement section of your job (see the CRM 
Basic Access Methods reference manual). 
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OWNCODE ROUTINES 



You can write a routine to insert, substitute, 
modify, or delete input and output records during 
Sort/Merge processing. Your routine, called an 
owncodc routine, is executed each time the sort or 
merge reaches a certain point. Sort/Merge passes a 
record to the owncode routine, which processes the 
record. When the record is returned to Sort /Merge 
from the owncode routine, Sort/Merge processes the 
record according to an option specified by the 
owncode routine. Owncode routines can also supply 
the records to be sorted; when Sort /Merge is ready 
for a record, the owncode routine passes a record 
to Sort /Merge. 

Owncode routines are routines written in FORTRAN 
(subroutine subprograms) or some other language 
that have been compiled and saved in relocatable 
binary form. The file containing your owncode 
routines is automatically loaded during Sort/Merge 
processing. This section describes specifying 
owncode routines and the available processing 
options . 

SPECIFYING OWNCODE ROUTINES 

To specify owncode routines when you are using 
control statement calls to Sort/Merge, you use the 
OWNF parameter. The OWNF parameter gives Sort/ 
Merge the name of the file containing your owncode 
routines; the file is loaded by Sort/Merge by means 
of the user call loader so that the routines are 
available during Sort/Merge processing. The names 
of your owncode routines are specified with the 
OWNn parameter; n is an integer from 1 through 5 
that tells Sort/Merge at which point in processing 
the routine is executed. You must supply a sepa- 
rate subroutine for each OWNn specified. 

When you are using procedure calls to Sort/Merge, 
you call SM50WNn to specify the name of an owncode 
routine and to indicate at which point in process- 
ing the routine is executed. Owncode routines must 
be loaded along with the Sort/Merge procedures. In 
a FORTRAN program, you must name the owncode rou- 
tines in an EXTERNAL statement. You cannot call 
SM50WNn from a COBOL program because there is no 
way (other than CALL or ENTER) to tell COBOL the 
name of an external subroutine. You can write a 
subroutine in FORTRAN or some other language to 
call the owncode routine. 

Owncode exits 1 and 2 can be taken from a sort 
only; exits 3, 4, and 5 can be taken from a sort or 
merge. 



OWNCODE ROUTINE PARAMETERS 

Owncode routines are called with parameters. Up to 
five parameters are passed between Sort/Merge and 
your owncode routine. Parameters are passed at the 
point in processing at which your owncode routine 



is executed. Figure 7-1 shows the format for 
naming an owncode routine in a control statement 
and in a procedure call , and the subroutine state- 
ment format, which is a standard FORTRAN subroutine 
statement . 



OWNn=proc 



CALL SM50WNn(proc) 



SUBROUTINE proc(retum_code,reca,rla[,recb,rlb] ) 



Figure 7-1. Owncode Routine Call and Subroutine 
Statement Formats 

If you specify an owncode 1, owncode 2, owncode 3, 
or owncode 4 routine, the return_code, reca, and 
rla parameters are passed by Sort/Merge. If you 
specify an owncode 5 routine, the recb and rib 
parameters are passed in addition to the other 
three parameters. The parameters are described in 
the following paragraphs. 

The return_code parameter is passed by Sort/Merge 
to an owncode routine as an integer with value 0. 
The return_code parameter can be altered by the 
owncode routine to the integer value 1, 2, or 3. 
The value returned to Sort/Merge by this parameter 
indicates a specific action to be taken by Sort/ 
Merge. A return_code value that is not defined 
causes a catastrophic error. The meanings of the 
various return_codes are discussed later in this 
section. 

The reca parameter is an otherwise empty array that 
is used to pass the current record; except for the 
current record, the contents of reca are unde- 
fined. The rla parameter passes a value that is 
the number of characters in the current record 
being sorted or merged. 

The recb and rib parameters are used when proc- 
essing two records with equal keys. The recb 
parameter passes the second .record; the rib 
parameter passes a value that is the number of 
characters in the second record. 

The allowed length of records passed to an owncode 
routine depends on how you have specified record 
length. If you have specified the OWNFL parameter 
or have called the SM50FL procedure, the number of 
characters in the current record must be the same 
as the OWNFL or SM50FL value. Otherwise, the 
maximum record length is determined as the largest 
MRL or FL FIT field in a CYBER Record Manager FILE 
control statement, or the largest value from the 
OWNMRL parameter or the SM50MRL procedure; all 
records must contain between one and this maximum 
record length number of characters, inclusive. An 
rla or rib parameter value that does not correspond 
to a record specification causes a catastrophic 
error. 
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The reca, rla, recb, and rib parameters can be 
altered by an owncode routine; the routine can pass 
a different record back to Sort/Merge in reca or 
recb, and the number of characters in the record 
can be different. The parameters must be passed 
from an owncode routine in order: return_code, 
reca, rla, recb, and rib. The arrays reca and recb 
can be any type of array. 

Table 7-1 summarizes the owncode routines and the 
parameters passed. Figure 7-2 illustrates record 
movement from Sort/Merge to an owncode routine and 
back to Sort/Merge. 

OWNCODE 1: PROCESSING 
INPUT RECORDS 

The 0WN1 parameter or the SM50WN1 procedure call 
names an owncode 1 routine that is executed in one 
of two instances . 

If you have specified input files with the FROM 
parameter or the SM5FR0M procedure call, the 
owncode 1 routine is executed after reading each 
record. The return_code, reca, and rla parameters 
are passed to the routine by Sort/Merge. The 
return code is 0, reca contains the record, and rla 
is the - record length in characters. After owncode 



processing of the record, control returns to 
Sort/Merge, which processes .the record passed back 
in reca according to the return_code value set by 
the owncode 1 routine (the record passed back to 
Sort/Merge in reca can be different from the record 
passed to the routine). The return_code value and 
the associated processing performed by Sort/Merge 
can be as follows: 



The record passed back to Sort/Merge in 
reca is sorted. 

1 The record passed back to Sort /Merge in 
reca is deleted. 

2 An additional record is inserted into the 
sort. The record in reca is entered into 
the sort, and the owncode 1 routine is 
executed again with reca and rla set to the 
record that just entered the sort. 

3 Input from the current file is terminated. 
The record in reca and remaining records in 
the file are not sorted. If more input 
files are specified, records are read from 
the next input file. The owncode 1 routine 
is executed after reading each record from 
this next file. 



TABLE 7-1. OWNCODE ROUTINE SUMMARY 



Routine 
Type 


Processing 


Parameters Passed 


Return code Value 


Return_code 


reca 


rla 


recb 


rib 


Owncode 1 


Input records 


X 


X 


X 






Sort current record. 

1 Delete current record. 

2 Insert new record. 

3 Terminate input from 
current file. 


Owncode 2 


Input files 


X 


X 


X 






Begin processing next 
input file. 

1 Insert new record. 


Owncode 3 


Output records 


X 


X 


X 






Modify current record. 

1 Delete current record. 

2 Create new record. 

3 Terminate output. 


Owncode 4 


Output files 


X 


X 


X 






Sort or merge is complete. 

1 Insert new record. 


Owncode 5 


Equal keys 


X 


X 


X 


X 


X 


Retain both records. 

1 Replace both records with 
new record. 
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Figure 7-2. Owncode Routine Record Flow 



If you have not specified any input files, the 
owncode 1 routine is executed when Sort/Merge 
is ready for another record to process. The 
return_code, reca, and rla parameters are passed to 
the routine by Sort /Merge. The return_code is 0, 
reca is an empty array with room for the largest 
record, and rla is 0. When control is returned 
to Sort /Merge from the owncode 1 routine, the 
returncode value and the associated processing 
performed by Sort/Merge can be as follows: 

The record passed back to Sort/Merge in 
reca is sorted. 

2 An additional record is inserted into the 
sort. The record in reca is entered into 
the sort, and the owncode 1 routine is 
executed again with reca and rla set to the 
record that just entered the sort. 

3 Input is terminated. 



OWNCODE 2: PROCESSING 
INPUT FILES 

The 0WN2 parameter or the SM50WN2 procedure call 
names an owncode 2 routine that is executed in one 
of two instances. 

If you have specified input files with the FROM 
parameter or the SM5FR0M procedure call, the 
owncode 2 routine is executed after input from a 
file has terminated (input terminates when end- 
of-section is found on file INPUT, when end-of-file 
is found on any other file, or when an owncode 1 
routine passes a return_code value of 3 to Sort/ 
Merge). The return_code, reca, and rla parameters 
are passed to the routine by Sort/Merge. The 
return_code is 0, and reca and rla are passed as a 
null record; reca is an empty array, and record 
length is 0. When control is returned to Sort/ 
Merge from the owncode 2 routine, the return_code 
value and the associated processing performed by 
Sort /Merge can be as follows: 



Processing of the next input file, if any, 
begins . 

1 An additional record is inserted into the 
sort after the last record. The record 
inserted is the first rla characters in 
reca, which have been provided by the . 
routine. The owncode 2 routine is executed 
again. 

If you have not specified any input files, the 
owncode 2 routine is executed after an owncode 1 
routine has terminated input. The return_code, 
reca, and rla parameters are passed to the routine 
by Sort/Merge. The return_code is 0, and reca and 
rla are passed as a null record. When control is 
returned to Sort/Merge from the owncode 2 routine, 
the return_code value and the associated processing 
performed by Sort /Merge can be as follows: 

Signals the end of input. 

1 An additional record is inserted into the 
sort after the last record. The record 
inserted is the first rla characters in 
reca, which have been provided by the 
routine. The owncode 2 routine is executed 
again. 

OWNCODE 3: PROCESSING 
OUTPUT RECORDS 

The 0WN3 parameter or the SM50WN3 procedure call 
names an owncode 3 routine that is executed in one 
of two instances. 

If you have specified an output file with the TO 
parameter or the SM5T0 procedure call, the own- 
code 3 routine is executed before writing a record 
to the output file. The return_code, reca, and rla 
parameters are passed to the routine by Sort/ 
Merge. The return_code is 0, reca is the record, 
and rla is the record length in characters. After 
owncode processing of the record, control returns 
to Sort/Merge, which processes the record passed 
back in reca according to the return_code value set 
by the owncode 3 routine. The return_code value 
and the associated processing performed by Sort/ 
Merge can be as follows: 

The record passed back to Sort/Merge in 
reca is written to the output file. 

1 The record passed back to Sort /Merge in 
reca is deleted. 

2 An additional record is written to the 
output file. The record in reca is written 
out, and the owncode 3 routine is executed 
again with reca and rla set to the original I 
record . | 

3 Output from the current file is termi- 
nated. The record in reca is not written 
out. If an owncode 4 routine is specified, 
it is executed; otherwise, the sort or 
merge is terminated. 
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If you have not specified an output file, the 
owncode 3 routine is executed when a record is 
ready for output; sorted or merged records are 
processed by the routine. The return_code, reca, 
and rla parameters are passed to the routine by 
Sort/Merge. The return_code is 0, reca is the 
record, and rla is the record length in char- 
acters. When control is returned to Sort/Merge 
from the owncode 3 routine, the return_code value 
and the associated processing performed by Sort/ 
Merge can be as follows: 

1 The record passed back to Sort /Merge in 
reca is deleted. 

3 Output is terminated. If an owncode 4 
routine is specified, it is executed; 
otherwise, the sort or merge is terminated. 



OWNCODE 4: PROCESSING 
OUTPUT FILES 

The 0WN4 parameter or the SM50WN4 procedure call 
names an owncode 4 routine that is executed in one 
of two instances. 

If you have specified an output file with the TO 
parameter or the SM5T0 procedure call, the owncode 
4 routine is executed after the last record has 
been written to the output file. The return_code, 
reca, and rla parameters are passed to the routine 
by Sort /Merge. The return_code is 0, and reca and 
rla are passed as a null record. When control is 
returned to Sort/Merge from the owncode 4 routine, 
the return_code value and the associated processing 
performed by Sort/Merge can be as follows: 

The sort or merge is completed. 

1 An additional record is inserted after the 
last record. The record inserted is the 
first rla characters in reca. The owncode 
4 routine is executed again. 

If you have not specified an output file, the 
owncode 4 routine is executed after an owncode 3 
routine has terminated output. The return_code, 
reca, and rla parameters are passed to the routine 
by Sort/Merge. The return_code is 0, and reca and 
rla are passed as a null record. When control is 
returned to Sort/Merge from the owncode 4 routine, 
the return_code value and the associated processing 
performed by Sort/Merge can be as follows: 



The sort or merge is completed. 

1 This value is not allowed since no output 
file has been specified. 



OWNCODE 5: PROCESSING 
RECORDS WITH EQUAL KEYS 

The 0WN5 parameter or the SM50WN5 procedure call 
names an owncode 5 routine that is executed when 
two records with equal key values are encountered 
during a sort or merge (when you have defined your 
own collating sequence, key values can be equal 
even if key characters are not identical). The 
return_code, reca, rla, recb, and rib parameters 
are passed to the routine by Sort /Merge. The 
return_code is 0; reca and recb contain the first 
and second records, respectively, and rla and rib 
contain the record lengths in characters of the 
first and second records, respectively. After 
owncode 5 routine processing of the two records, 
control is returned to Sort/Merge, which processes 
the records according to the return_code value set 
by the owncode 5 routine. The return_code value 
and the associated processing performed by Sort/ 
Merge can be as follows: 

The first rla characters of reca are 
accepted as the first record; the first rib 
characters of recb are accepted as the 
second record (the records and record 
lengths passed back to Sort/Merge can be 
different from the records and record 
lengths passed to the owncode routine). 

1 One duplicate record is deleted. The other 
record is replaced with the first rla char- 
acters of reca. 



If you specify RETAIN=YES or call the SM5RETA 
procedure in a sort with an owncode 5 routine, the 
record that entered the sort first is passed to the 
owncode routine as reca; otherwise, either of the 
two records with equal keys could be passed to the 
routine as reca. The owncode 5 routine can control 
the order in which the two records are returned to 
Sort/Merge. The record returned to Sort/Merge as 
reca is entered into the sort before the record 
returned as recb. An owncode 5. routine cannot be 
specified in the same sort as a SUM parameter or 
SM5SUM procedure. 
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This section contains examples of sorts and 
merges. The first example is a simple control 
statement sort on one key. The same sort is illus- 
trated using the Interactive dialog. A control 
statement sort on multiple keys, a control state- 
ment merge, directive file creation and use, SUM 
parameter use, and a FORTRAN program with Sort/ 
Merge procedure calls and an owncode routine are 
also included. 



CONTROL STATEMENT SORT ON 
ONE KEY 

Figure 8-1 shows the record layout in a university- 
student file named UNIVER. Each record includes 
the last name and first and middle initials, the 
student number, the date of birth, the field of 
study, the grade point average, and a code repre- 
senting class (freshman, sophomore, junior, 
senior); all fields are written with character 
data. The file is maintained with the student 
number as the major key. Records are normally 
ordered in ascending order according to the student 
number as shown in figure 8-2 with file UNIVER. 

Figure 8-3 shows the job structures for sorting 
file UNIVER to give an alphabetic list of 
students. Under both NOS and NOS/BE operating 
systems, the job statements and accounting infor- 
mation are followed by ATTACH commands to assign 
the file to the job. CYBER Record Manager (CRM) 
FILE control statements are included, because the 
input and output records contain only 38 characters 
each, considerably less than the default of ISO. 
The S0RT5 control statement calls for records from 
UNIVER to be sorted on a key that occupies charac- 
ter positions 1 through 10 in each record according 
to the default ASCII6 collating sequence in ascend- 
ing order. Sorted records are written to file 
SRTOUT, which is created as a local file during the 
sort. File SRTOUT is then copied to file OUTPUT 
with a right shift, because the first character in 
the print line is reserved for carriage control. 
Figure 8-4 shows the output from the job. 
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Figure 8-2. File UNIVER 



SORT SPECIFICATION USING 
INTERACTIVE DIALOG 

Figure 8-5 shows the interactive dialog used to 
specify the same sort of file UNIVER on the last 
name. The input file is assigned to the job with 
an ATTACH command under NOS or a FETCH command 
under NOS/BE. CRM FILE control statements are 
entered for the input and output files. The dialog 
is invoked by typing DIALOG-YES. Sorted records 
are written to file S0RT0UT, which Sort/Merge 
creates as a local file. File SORTOUT can be 
printed or displayed at the terminal; SORTOUT can 
also be routed to a printer or saved as a permanent 
file. 
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Figure 8-1. File UNIVER Record Layout 
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NOS Operating System 

Job statement 

USER statement 

CHARGE statement 

ATTACH.UNIVER. 

FILE{UNIVER,BT=C,RT=Z,FL=38) 

FILE(SRTOUT,BT=C,RT=Z,FL=38) 

SORT5.FROM=UNIVER,TO=SRTOUT,KEY=1. .10 

COPYSBF,SRTOUT,OUTPUT. 

EOI 

NOS/BE Operating System 

Job statement 

ACCOUNT statement 

ATTACH,UNIVER,ID=PUBS. 

FILE(UNIVER,BT=C,RT=Z,FL=38) 

FILE(SRTOUT,BT=C,RT=Z,FL=38) 

SORT5.FROM=UNIVER,TO=SRTOUT,KEY=1. .10 

COPYSBF,SRTOUT,OUTPUT. 

EOI 



Figure 8-3. Job Structure for Sorting File 
UNIVER on Last Name 
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Figure 8-4. File UNIVER Sorted on Last Name 



/attach, univer 

/f ile(univer,bt=c,rt=z,f 1=38) 

FILECUNIVER,BT=C,RT=Z,FL=38) 

/fUe(sortout,bt = c,rt = z,f 1=38) 

FILE<S0RT0UT,BT=C,RT=Z,FL=3 8) 

/sort5.dialog=yes 

ARE YOU SURE THAT ALL YOUR FILES (IF ANY) ARE EITHER 

STANDARD UNIT RECORD FORMAT OR HAVE HAD FILE CONTROL 

STATEMENTS SPECIFIED FOR THEN 
? yes 

DO YOU HAVE JUST ONE INPUT FILE AND NO OWN1 OR 0WN2 SUBROUTINES 
? yes 

WHAT IS THE NAME OF YOUR INPUT FILE 
? univer 

DO YOU HAVE ANY OWN3 OR 0WN4 SUBROUTINES 
? no 

WHAT IS THE NAME OF YOUR OUTPUT FILE 
? sortout 

THE STANDARD COLLATING SEQUENCE IS ASCII6. 

HERE IS THE WHOLE ASCII6 COLLATING SEQUENCE LISTED 
!"#$X8' ()*+,-./ 01 23 456789 :;<=>?3 ABC DEFGHI J KLNN0P8RSTUVWXYZC\]"_ 

DO ALL OF YOUR KEYS CONSIST OF CHARACTER DATA TO BE SORTED 

ACCORDING TO THE ASCII6 COLLATING SEQUENCE 
? yes 

ASCENDING ORDER OF THE ASCII6 COLLATING SEQUENCE MEANS THE 

NORMAL ORDER. 
'."#*%&• ()* + ,-,. /01 23456789 : ;<=>?aABCDEFGHI JKLMNOPQRSTUVWXYZCU *_ 

DESCENDING ORDER MEANS THE REVERSE ORDER. 

_"3\CZYXWVUTSRQP0NMLKJIHGFEDCBA3?>=<; : 9876543210/ .-,+*) C8%$#"! 

DO YOU WANT ALL YOUR KEYS SORTED IN ASCENDING ORDER 
? yes 

HOW MANY KEY FIELDS DO YOU HAVE 
? 1 

THE LEFT-MOST CHARACTER OF A RECORD IS NUMBER 1. 

FOR THE MOST IMPORTANT KEY FIELD, WHAT IS THE NUMBER 

OF THE LEFT MOST CHARACTER 
? 1 

HOW MANY CHARACTERS ARE IN THE MOST IMPORTANT KEY FIELD 
? 10 

DO YOL WANT RECORDS WITH EQUIVALENT KEY VALUES TO BE WRITTEN 

IN THE SAME ORDER THEY ARE READ 
? no 

GIVE AN ESTIMATE OF THE MAXIMUM NUMBER OF RECORDS TO BE SORTED 
? 75 

THANK YOU. SORT/MERGE NOW BEGINS. 
SORTS. DIALOG=YES 
/ 



Figure 8-5. Interactive Dialog Example 
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CONTROL STATEMENT SORT ON 
MULTIPLE KEYS 

Figure 8-6 shows the job structures for sorting 
file UNIVER on three keys. Under both NOS and 
NOS/BE, the job statements and accounting informa- 
tion are followed by ATTACH commands to assign the 
file to the job. CRM FILE control statements for 
the input and output files are included. The SORTS 
control statement calls for records to be first 
sorted on the field of study, which occupies char- 
acter positions 27 through 34 in each record. 
Records with equal keys for the major key are then 
sorted on the class code, which is a 1 -character 
field in position 38. The third key sorts students 
with the same field of study and class by the last 



NOS Operating System 

Job statement 

USER statement 

CHARGE statement 

ATTACH.UNIVER. 

FILE(UNIVER.BT=C,RT=Z,FL=38) 

Fl LE(SRTOUT,BT=C,RT=Z,F L=38) 

SORT5.FROM=UNIVER,TO=SRTOUT, 

.KEY=((27. .34),<38,1),{1. .10)) 

COPYSBF.SRTOUT.OUTPUT. 

EOI 



NOS/BE Operating System 

Job statement 

ACCOUNT statement 

ATTACH,UNIVER,ID=PUBS. 

FILE(UNIVER,BT=C,RT=2,FL=38) 

FILE(SRTOUT.BT=C,RT=Z,FL=38) 

SORT5.FROM=UNIVER,TO=SRTOUT, 

.KEY=«27. .34),(38,1).(1. .10)) 

COPYSBF,SRTOUT.OUTPUT. 

EOI 



Figure 8-6. Job Structure for Control Statement 
Sort on Multiple Keys 

Figure 8-6 illustrates continuing the SORTS control 
statement beyond one line. The first line of the 
control statement is terminated with three periods; 
the second line begins with one period. Sorted 
records are written to the file SRTOUT, which is 
then copied to file OUTPUT with a right shift, 
because the first character in the print line is 
reserved for carriage control. Figure 8-7 shows 
the output from the job. 



CONTROL STATEMENT MERGE 

Figure 8-8 shows two files (UNIVER, ADDSTU) ordered 
according to the student number. The two files can 
be merged because they are sorted on the same key. 
Figure 8-9 shows the job structures to merge the 
two files. Under both NOS and NOS/BE, the two 
files are attached. A new file (NEWU) is created 
as a permanent file to which merged records are 
written; under NOS, the DEFINE command creates an 
empty direct access permanent file. Under NOS/BE, 
the BEQUEST command assigns NEWU to a permanent 
file device; the CATALOG command then makes the 
file permanent. CRM FILE control statements for 
the input files and the merged file are included. 
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Figure 8-7. File UNIVER Sorted on Multiple Keys 



A. File UNIVER 
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B. File ADDSTU 
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Figure 8-8. Input Files for Control Statement Merge 
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NOS Operating System 



Job statement 

USER statement 

CHARGE statement 

ATTACH,UNIVER,ADDSTU. 

DEFINE.NEWU. 

FILE{UNIVER,BT=C,RT=Z,FL=38) 

FILE(ADDSTU,BT=C,RT=Z,FL=38) 

FILE(NEWU,BT=C,RT=Z,FL=38) 

MERGE.FROM=(UNIVER.ADDSTU),TO=NEWU,KEY=15. .20 

COPYSBF,NEWU,OUTPUT. 

EOI 



NOS/BE Operating System 



Job statement 

ACCOUNT statement 

ATTACH,UNIVER,ID=PUBS. 

ATTACH,ADDSTU,ID=PUBS. 

REQUEST,NEWU,*PF. 

FILE(UNIVER,BT=C,RT=Z,FL=38) 

Fl LE(ADDSTU,BT=C,RT=Z,FL=38) 

FILE(NEWU,BT=C,RT=Z,FL=38) 

MERGE.FROM=(UNIVER,ADDSTU),TO=NEWU,KEY=15. .20 

CATALOG,NEWU,ID=PUBS,XR=CHNG. 

COPYSBF,NEWU,OUTPUT. 

EOI 



Figure 8-9. Job Structure for Control Statement Merge 



The MERGE control statement names the two input 
files and the new output file. The key on which 
the files are merged is the student number (the 
field on which the files are presorted) . The 
merged file is copied to file OUTPUT with a right 
shift, because the first character in the print 
line is reserved for carriage control. Figure 8-10 
shows the output from the job. 
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Figure 8-10. Merged File NEWU 



CREATING AND USING A 
DIRECTIVE FILE 

Figure 8-11 shows a portion of a terminal session 
in which a directive file is created. In the first 
part of figure 8-11, the directive file is created 
using XEDIT under NOS; (Sy denotes carriage 
return. In the second part of the figure, the 
directive file is created using EDITOR under NOS/BE. 

Under NOS, XEDIT is entered after login, and the 
directive file to be created is given the name 
DIRFIL. The directive file statements begin with 
the word SORT followed by a comma. The statements 
specify a user-defined collating sequence named 
MYSEQ. The first SEQS parameter specifies ten 
steps from to 9; the other SEQS parameter speci- 
fies one step consisting of hyphens, blanks, and 
slashes. The SEQA parameter specifies that blanks 
and slashes are to be output as hyphens. The 
directive file is then reviewed (still using XEDIT) 
to make sure the file is accurate. The file DIRFIL 
is saved. as an indirect access permanent file. 

Under NOS/BE, EDITOR is entered after login. The 
statements of the directive file are identical to 
the statements entered under NOS, and the directive 
file is then reviewed using the LIST command. 
Using the SAVE command, DIRFIL is made a local file 
without sequence numbers; the CATALOG command saves 
the file as a permanent file. 

Figure 8-12 shows a portion of a NOS terminal ses- 
sion in which a file named NUMFIL (figure 8-13) is 
sorted according to the MYSEQ collating sequence. 
The directive file and the input file are assigned 
to the job with GET commands for indirect access 
permanent files. CRM FILE control statements are 
entered for the input and output files. 

The S0RT5 control statement is then entered naming 
the input and output files, the key field, and the 
directive file; the name of the user-defined 
collating sequence is the key type. After Sort/ 
Merge reads the directive file, an image of this 
file is printed or displayed at the terminal (the L 
parameter default is OUTPUT). When the sort is 
complete, the S0RT5 control statement is printed or 
displayed at the terminal (note that NOS repeats 
only 48 characters of the control statement) . 
Control is then returned to the operating system. 

Figure 8-14 shows the output from the job using the 
directive file with the MYSEQ collating sequence. 
The records are in numeric order, and the separa- 
tors in the number have been standardized as 
hyphens in all records 

SUM PARAMETER USE 

Figure 8-15 shows the record layout in a file named 
GRADES. Each record includes three numeric fields: 
number of units attempted, number of units com- 
pleted, and grade points. Figure 8-16 shows file 
GRADES with multiple records for each student. 
Records are to be sorted according to student 
number and, using the SUM parameter, records with 
the same student number are to be combined into one 
record by adding together the numeric fields to 
give the total number of units attempted, units 
completed, and the total number of grade points. 
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IMPS Operating System 



/xedi t,di rf i l,c -*- 
XEDIT 3.1.00 

f> _- 



INPUT -. 

? sort ,seqn=myseq \ 
? sort,seqs=('0* .. '9') ( 
? sortjSeqssC-',' , ,'/ , )J 
? sort,seqa=yes ' 



EDIT -. 

?? top -■ 

?? print*— 

SORT,SEaN=MYSEQ , 
S0RT,SEaS=( , 0' .. , 9') | 
BOR^EOS^ 1 - 1 ,' •,■/■)> 
S0RT,SE8A=YES ) 

END OF FILE 

?? end, di rfi I, replace -*- 
DIRFIL REPLACED 



NOS/BE Operating System 



Enter XEDIT In create mode; DIRFIL is the name 
gjLven the file to be created. 

Enter XEDIT input mode. 
Directive file statements. 



Enter XEDIT edit mode. 

Move pointer to the beginning of the file. 

Print the entire file. 



COMMAND- editor -*- 



. .1=sort ,seqn=myseq 

2=sort,seqs=< , 0« .. , 9') 

SssortjSeqs^C-' ,' , , , /*>J 

4=sort,seqa=yes 

List, a, sup -* 



SORT,SEQN=MYSEQ. ) 
S0RT,SEaS=('0' ..'9') I 

BCRT^aS^'-',* , ,'/')( 
S0RT,SE8A=YES > 

. .save,di rf i l,n — 

..end -« 



COMMAND- catalog, di rfi I, id=pubs -*- 



Directive file statements. 



Leave XEDIT and save DIRFIL as an indirect access 
permanent file. 



Enter EDITOR. 

Directive file statements. 

List the entire file. 
Directive file statements. 



Make edit file a local file without sequence numbers. 

Leave EDITOR. 

Save file as a permanent file named DIRFIL. 



Figure 8-11. Creating a Directive File 



/get,di rfi I 

/get,numf i I 

/file(nu*fil,bt=c,rt=z,f 1=35) 

FILE<NUHFIL,BT=C,RT=Z,FL=35> 

/fi leCseqf i l,bt=c,rt=z,f 1=35) 

FILE<SE«FIL,BT=C,RT=Z,FL=35) 

/sort5.f rom=numf i l,to=seqf i l,key=((25,11 ,myseq>) ,dir=dirf i I 

1 

SORT/MERGE 5.0 * LISTING OF DIRECTIVE FILE - DIRFIL 
12/04. 16.45.45. 

1. S0RT,SE0N=MYSEQ 

2. S0RT,SE«S=( , , .. , 9') 

3. BCRT^as^"- 1 ,' ■,■/■) 

4. S0RT,SEQA=YES 



SORT/MERGE 5 



18 RECORDS SORTED 



Figure 8-12. Using a Directive File (NOS) 
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Figure 8-13. File NUMFIL 
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Figure 8-14. Output From Sort Using a Directive File 



Figure 8-16. File GRADES 
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UNITS COMPLETED 



GRADE POINTS 



Figure 8-15. File GRADES Record Layout 
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Figure 8-17 shows the S0RT5 control statement with 
the SUM parameter. The input and output files are 
named, and the student number (character positions 
15 through 20) is specified as the sort key. The 
SUM parameter specifies that a 3-character numeric 
field of type NUMERIC_NS begins in position 36 in 
each record. The repetition indicator 3 specifies 
that three contiguous fields are to be summed. 
Figure 8-18 shows the output from the job. The 
output file contains one record for each student. 
The numeric fields are the totals of the units 
attempted, units completed, and grade points. 



A SORT USING PROCEDURE CALLS 

Figure 8-19 shows the job structures for performing 
a sort from within a FORTRAN program. Under both 
NOS and NOS/BE, the job statements and accounting 
information are followed by ATTACH commands to 
assign the input data file (UNIVER) and the file 
containing the FORTRAN source program to the job. 
The FORTRAN 5 compiler is called, and the program 
is compiled. The program is then executed (LGO). 

Figure 8-20 shows the FORTRAN program containing 
the Sort/Merge procedure calls. File UNIVER is 
read, and student records with grade point average 



of 3.50 or better are written to an intermediate 
file (INT1). Sort/Merge is. called to sort the file 
on grade point average in descending order (highest 
grade point average to lowest grade point aver- 
age). The SM5S0RT call names a result array that 
is dimensioned as a 16-element integer array and 
the first element set to 15 to receive the maximum 
number of sort results and statistics. 

The SM50WN1 call specifies that an owncode 1 
routine named CCODE is to be executed after Sort/ 
Merge reads each record from INT1. Records are 
passed to the routine by Sort/Merge. Figure 8-21 
shows the routine, which is a FORTRAN subroutine. 
The SUBROUTINE statement names the routine and the 
parameters passed by Sort/Merge. Parameter RETCODE 
is the return_code passed as 0, REC is an array 
containing the record, and RL is the record length 
in characters. The routine converts the class code 
in each record to the class name. The records are 
returned to Sort/Merge in array REC. The 
return_code value is left as because each record 
in this example is to be sorted. Sort/Merge then 
sorts the records to file INT2. The sorted file is 
returned to the FORTRAN program to be written out 
in a formatted report. Figure 8-22 shows the 
output from the job. which includes the report and 
the contents of the result array. 



/get, grades 

/fi le(grades,bt=c,rt=z,fl=44) 

FILE<GRADES,BT=C,RT=Z,FL=44) 

/f i le(sumex,bt=c,rt=z,f 1=44) 

FILE<SU«EX,BT=C,RT=Z / FL=44> 

/sortS.f rom=grades,to=suniex,key=1 5. . 20,sum=( (36,3,numeri c_ns,3) ) 

SORT/MERGE 5 - 47 RECORDS SORTED 

/ 



Figure 8-17. Interactive Parameter Specification for SUM Example 
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Figure 8-18. Output From SUM Example 
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NOS Operating System 

Job statement 

USER statement 

CHARGE statement 

ATTACH,UNIVER,SM5£X. 

FILE(UNIVER,BT=C,RT=Z,FL=38) 

FTN5,l=SM5EX,L=OUTEX. 

LGO. 

COPY.OUTEX.OUTPUT. 

EOI 



NOS/BE Operating System 

Job statement 

ACCOUNT statement 

ATTACH,UNiV£R.ID=PUBS. 

ATTACH.SM5EX,ID=F. 

FILE(UNIVER,BT=C,RT=Z,FL=38) 

FTN5,l=SM5EX,L=OUT£X. 

LGO. 

COPY,OUTEX,OUTPUT. 

EOI 



Figure 8-19. Job Structure for Sort Called From a FORTRAN Program 



1 






PROGRAM DUST 




2 






INTEGER GPA 




3 






CHARACTER SNANE*14, MAJ0R*8, C0t>E*1 , CLASS*12 




4 






DIMENSION IARAYC16) 




5 






COMMON /CONN/ CODE, CLASS 




6 

7 
3 


C 




EXTERNAL CCODE 




1 


READ(L"UNIVER" / 100,END=10) SNAME, MAJOR, GPA, CODE 




9 






IF (GPA .GE. 350) WRITECL" INT1 ",200) SNAME, MAJOR, GPA, 


CODE 


10 






GO TO 1 




11 


C 








12 




10 


IARAY(1)*15 




13 






CALL SM5S0RTUARAY) 




14 






CALL SM50FL(80) 




15 






CALL SMSFROMCINTV) 




16 






CALL SMil^Y^^'ASCI^',^*) 




17 






CALL SM50WN1 (CCODE) 




18 






CALL SN5T0( , INT2'> 




19 






CALL SM5END 




20 






REWIND(L"INT2") 




21 


C 








22 






PRINT *, IARAY 




23 






WRIT6(L"0UTEX",400) 




24 




15 


READ(L M INT2",300,END*20) SNAME, MAJOR, GPA, CLASS 




25 






WRITE(L"OUTEX",500) SNAME, MAJOR, CLASS, GPA 




26 






GO TO 15 




27 


C 








28 




100 


FORMAT (A14,12X,A8,I3,A1) 




29 




200 


FORMAT (A14,5X,A8,5X,I3,5X,A1,39X) 




30 




300 


FORMAT (A14,5X,A8,5X,I3,5X,A12,28X) 




31 




400 


FORMAT (36X, "DEAN'S LIST" // 1 5X, "STUDENT" , 




32 






* 12X, "MAJOR", 8X, "CLASS", 12X, "GPA", 65X /) 




33 




500 


FORMAT (15X,A14,5X,A8,5X,A12,5X,I3,59X) 




34 


C 








35 




20 


STOP 




36 






END 





Figure 8-20. FORTRAN Program With Sort/Merge Procedure Calls 
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1 


C 




2 




SUBROUTINE CCODE (RETCODE,REC,RL) 


3 




INTE6ER RETCODE, RL 


4 




CHARACTER C1*6, C2*6, C3*9, C4*3, C5*12, 


5 




* C0DE*1, CLASS*12, REC(*>*12 


6 




COMMON /SUBCOM/ CODE, CLASS 


7 




DATA C1,C2/'SENI0R', 'JUNIOR'/ 


n 




DATA C3,C4/'SOPH0M0RE*,' FRESHMAN'/ 


9 




DATA C5/'UNCLASSIFIED'/ 


10 


C 




11 




CODE = REC(4>(5:5> 


12 




IF (CODE .EQ. '1') THEN 


13 




CLASS = C1 


14 




ELSE IF (CODE .EQ. '2') THEN 


15 




CLASS = C2 


16 




ELSE IF (CODE .EQ. '3') THEN 


17 




CLASS = C3 


18 




ELSE IF (CODE .EQ. '4') THEN 


19 




CLASS = C4 


20 




ELSE IF (CODE .EQ. '5') THEN 


21 




CLASS = €5 


22 




ELSE 


23 




PRINT *, CODE 


24 




END IF 


25 




REC(4)(5:12> = CLASS(1:8) 


26 




REC(5>(1:4) = CLASS(9:12) 


27 




RETURN 


28 




END 



Figure 8-21. Owncode Routine 
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Figure 8-22. Output From FORTRAN Program 
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CHARACTER DATA INPUT, OUTPUT, AND, 
CENTRAL MEMORY REPRESENTATION 



This appendix describes the code and character sets 
used by host computer operating system local batch 
device drivers, magnetic tape drivers, and terminal 
communication products. Some software products 
assume that certain graphic or control characters 
are associated with specific binary code values for 
collating or syntax processing purposes. This 
appendix does not describe those associations. 

All references within this manual to the ASCII 
character set or the ASCII code set refer to the 
character set and code set defined in the American 
National Standard Code for Information Interchange 
(ASCII, ANSI Standard X3. 4-1977). References in 
this manual to the ASCII character set do not 
necessarily apply to the ASCII code set. Sort/ 
Merge uses a 63- or 64-character subset of the full 
ASCII set. Only characters in 6-bit or internal 
BCD display code should be used with Sort/Merge. 

CHARACTER SETS AND CODE SETS 

A character set differs from a code set. A char- 
acter set is a set of graphic and/or control char- 
acters. A code set is a system of symbols used to 
represent each character within a character set. 
Characters exist outside the computer system and 
communication network; codes are received, stored, 
retrieved, and transmitted within the computer 
system and network. 

GRAPHIC AND CONTROL 
CHARACTERS 

A graphic character can be displayed at a terminal 
or printed by a line printer. Examples of graphic 
characters are the characters A through Z, a blank, 
and the digits through 9. A control character 
initiates, modifies, or stops a control operation. 
An example of a control character is the backspace 
character, which moves the terminal carriage or 
cursor back one space. Although a control char- 
acter is not a graphic character, some terminals 
can produce a graphic representation when they 
receive a control character. 

CODED AND BINARY 
CHARACTER DATA 

Character codes can be interpreted as coded char- 
acter data or as binary character data. Coded 
character data is converted from one code set 
representation to another as it enters or leaves 
the computer system; for example, data received 
from a terminal or sent to a magnetic tape unit is 
converted. Binary character data is not converted 
as it enters or leaves the system. Character codes 
are not converted when moved within the system; for 
example, data transferred to or from mass storage 
is not converted. 

The distinction between coded character data and 
binary character data is important when reading or 



punching cards and when reading or writing magnetic 
tape. Only coded character data can be properly 
reproduced as characters on a line printer. Only 
binary character data can properly represent char- 
acters on a punched card when the data cannot be 
stored as display code. 

The distinction between binary character data and 
characters represented by binary data (such as 
peripheral equipment instruction codes) is also 
important. Only such binary noncharacter data can 
properly reproduce characters on a plotter. 



FORMATTED AND UNFORMATTED 
CHARACTER DATA 

Character codes can be interpreted by a product as 
formatted character data or as unformatted char- 
acter data. Formatted data can be stored or 
retrieved by a product in the form of the codes 
described for coded character data in the remainder 
of this appendix, or formatted data can be altered 
to another form during storage or retrieval; for 
example, 1 can be stored as a character code or as 
an integer value. Treatment of unformatted data by 
a product includes both coded character data and 
binary character data as described in this appendix. 

NETWORK OPERATING SYSTEMS 

The NOS and NOS/BE operating systems support the 
following character sets: 

• CDC graphic 64-character set 

• CDC graphic 63-character set 

• ASCII graphic 64-character set 

• ASCII graphic 63-character set 

• ASCII graphic 95-character set 

In addition, NOS supports the ASCII 128-character 
graphic and control set. 

Each installation must select either a 64-character 
set or a 63-character set. The differences between 
the codes of a 63-character set and the codes of a 
64-character set are described under Character Set 
Anomalies. Any reference in this appendix to a 64- 
character set implies either a 63- or 64-character 
set unless otherwise stated. 

To represent its six listed character sets in 
central memory, NOS supports the following code 
sets: 

• 6-bit display code 

• 12-bit ASCII code 

• 6/12-bit display code 
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To represent Its five listed character sets in 
central memory, NOS/BE supports the following code 
sets: 

• 6-bit display code 

• 12-bit ASCII code 

Under both NOS and NOS/BE, the 6-bit display code 
is a set of 6-bit codes from OOg to 77g. 

Under both NOS and NOS/BE, the 12-bit ASCII code is 
the ASCII 7-bit code (as defined by ANSI Standard 
X3. 4-1977) right-justified in a 12-bit byte. 
Assuming that the bits are numbered from the right 
starting with 0, bits through 6 contain the ASCII 
code, bits 7 through 10 contain zeros, and bit 11 
distinguishes the 12-bit ASCII OOOOg code from 
the end-of-line byte. The 12-bit codes are OOOlg 
through 0177 8 and 4000s. 

Under NOS, the 6/12-bit display code is a combina- 
tion of 6-bit codes and 12-bit codes. The 6-bit 
codes are 00g through 77g, excluding 74g and 
76g. (The interpretation of the OOg and 63s 
codes is described under Character Set Anomalies in 
this appendix.) The 12-bit codes begin with either 
74g or 76g and are followed by a 6-bit code. 
Thus, 74g and 76g are considered escape codes 
and are never used as 6-bit codes within the 
6/12-bit display code set. The 12-bit codes are 
7401g, 7402g, 7404g, 7407g, and 7601g 
through 7677g. All other 12-bit codes (74xxg 
and 7600g) are undefined. 



CHARACTER SET ANOMALIES 

The operating system input/output software and some 
products interpret two codes differently when the 
installation selects a 63-character set rather than 
a 64-character set. If an installation uses a 
63-character set, the colon graphic character is 
always represented by a 63g display code, display 
code OOg i s undefined (it has no associated 
graphic or punched card code), and the % graphic 
does not exist. 

However, under NOS, if the installation uses a 
64-character set, output of a 7404g 6/12-bit 
display code or a 00g display code produces a 
colon. A colon can be input only as a 7404g 
6/12-bit display code. The use of undefined 
6/12-bit display codes in output files produces 
unpredictable results and should be avoided. 

Under NOS/BE, if the installation uses a 64- 
character set, output of a OOg display code 
produces a colon. Display code 63g is the colon 
when a 63-character set is used. The % graphic and 
related card codes do not exist and translations 
yield a blank (55g). 

Under both NOS and NOS/BE, two consecutive OOg 
codes can be confused with an end-of-line byte and 
should be avoided. 



CHARACTER SET TABLES 

The character set tables A-l and A-2 are designed 
so that you can find the character represented by a 
code (such as in a dump) or find the code that 



represents a character. To find the character 
represented by a code, look up the code in the 
column listing the appropriate code set and then 
find the character on that line in the column 
listing the appropriate character set. To find the 
code that represents a character, look up the 
character and then find the code on the same line ■ 
in the appropriate column. 



Conversational Terminal Users 

Table A-l shows the character sets and code sets 
available to an Interactive Facility (IAF) or 
INTERCOM user at an ASCII code terminal using an 
ASCII character set. The Full ASCII Character Set 
table (later in this appendix) shows the octal and 
hexadecimal 7-bit ASCII code for each ASCII char- 
acter, and can be used to convert codes from octal 
to hexadecimal. (Under NOS using network product 
software, certain Terminal Interface Program com- 
mands require specification of an ASCII code. 



IAF Usage 

When in normal time-sharing mode (specified by the 
IAF NORMAL command), IAF assumes the ASCII graphic 
64-character set is used and translates all input 
and output to or from display code. When in ASCII 
time-sharing mode (specified by the IAF ASCII 
command) , IAF assumes the ASCII 128-character set 
is used and translates all input and output to or 
from 6/12-bit display code. 

The IAF user can convert a 6/12-bit code file to a 
12-bit ASCII code file using the NOS FC0PY control 
statement. The resulting 12-bit ASCII file can be 
routed to a line printer but cannot be output 
through IAF. 

IAF supports both character mode and transparent 
mode transmissions through the network. These 
transmission modes are described under Network 
Access Method Terminal Transmission Code Sets in 
this appendix. IAF treats character mode trans- 
missions as coded character data; IAF converts 
these transmissions to or from either 6-bit or 
6/12-bit display code. IAF treats transparent mode 
transmissions as binary character data; transparent 
mode communication between IAF and ASCII terminals 
using any parity setting occurs in the 12-bit ASCII 
code shown in table A-l . 



INTERCOM Usage 

By default, INTERCOM displays the ASCII graphic 
64-character set and interprets all input and 
output as display code. Refer to the INTERCOM 
reference manual. 

COMPASS and FORTRAN users can elect to use 12-bit 
ASCII code if the terminal in use supports the code 
set selected. BASIC users can elect to send and 
receive lowercase and uppercase character codes 
using the 12-bit ASCII code if the terminal in use 
supports the code set selected; BASIC represents 
coded character data in central memory using 
6/12-bit display code in both the NOS and NOS/BE 
systems. 



A-2 
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TABLE A-l. CONVERSATIONAL TERMINAL CHARACTER SETS 



ASCII 


ASCII 


Octal 


Octal 


Octal 


ASCII 


ASCII 


Octal 


Octal 


Octal 


Graph i c 


Character 


6-Bit 


6/12-Bit 


12-Bit 


Graphic 


Character 


6-Bit 


6/12-Bit 


12-Bit 


(64-Char- 


(128-Char- 


Display 


Display 


ASCII 


<64-Char- 


(128-Char- 


Display 


Display 


ASCII 


acter Set) 


acter Set) 


Code 


Code* 


Code 


acter Set) 


acter Set) 


Code 


Code* 


Code 


: colon™ 




00™ 








■*■ circumflex 




7402 


0136 


A 


A 


01 


01 


0101 




: colon ft 




7404™ 


0072 


B 


B 


02 


02 


0102 




* grave accent 




7407 


0140 


C 


C 


03 


03 


0103 




a 




7601 


0141 


D 


D 


04 


04 


0104 




b 




7602 


0142 


E 


E 


05 


05 


0105 




c 




7603 


0143 


F 


F 


06 


06 


0106 




d 




7604 


0144 


6 


6 


07 


07 


0107 




e 




7605 


0145 


H 


H 


10 


10 


0110 




f 




7606 


0146 


I 


I 


11 


11 


0111 




9 




7607 


1047 


J 


J 


12 


12 


0112 




h 




7610 


0150 


K 


K 


13 


13 


0113 




i 




7611 


0151 


L 


L 


14 


14 


0114 




J 




7612 


0152 


H 


H 


15 


15 


0115 




k 




7613 


0153 


N 


N 


16 


16 


0116 




I 




7614 


0154 








17 


17 


0117 




m 




7615 


0155 


P • 


P 


20 


20 


0120 




n 




7616 


0156 


Q 


Q 


21 


21 


0121 




o 




7617 


0157 


R 


R 


22 


22 


0122 




P 




7620 


0160 


S 


S 


23 


23 


0123 




q 




7621 


0161 


T 


T 


24 


24 


0124 




r 




7622 


0162 


U 


U 


25 


25 


0125 




s 




7623 


0163 


V 


V 


26 


26 


0126 




t 




7624 


0164 


w 


w 


27 


27 


0127 




u 




7625 


0165 


X 


X 


30 


30 


0130 




V 




7626 


0166 


Y 


Y 


31 


31 


0131 




y 




7627 


0167 


z 


z 


32 


32 


0132 




X 




7630 


0170 








33 


33 


0060 




y 




7631 


0171 


1 


1 


34 


34 


0061 




z 




7632 


0172 


2 


2 


35 


35 


0062 




< left brace 




7633 


0173 


3 


3 


36 


36 


0063 




| vert. Line 




7634 


0174 


4 


4 


37 


37 


0064 




> right brace 




7635 


0175 


5 


5 


40 


40 


0065 




" tilde 




7636 


0176 


6 


6 


41 


41 


0066 




MUL 




7640 


4000 


7 


7 


42 


42 


0067 




SOH 




7641 


0001 


8 


8 


43 


43 


0070 




STX 




7642 


0002 


9 


9 


44 


44 


0071 




ETX 




7643 


0003 


+ plus 


+ plus 


45 


45 


0053 




EOT 




7644 


0004 


- minus 


- minus 


46 


46 


0055 




ENQ 




7645 


0005 


* asterisk 


* asterisk 


47 


47 


0052 




ACK 




7646 


0006 


/ slash 


/ slash 


so 


50 


0057 




BEL 




7647 


0007 


( I. paren. 


( I. paren. 


51 


51 


0050 




BS 




7650 


0010 


) r. paren. 


) r. paren. 


52 


52 


0051 




HT 




7651 


0011 


* dollar 


S dollar 


53 


53 


0044 




LF 




7652 


0012 


= equal to 


= equal to 


54 


54 


0075 




VT 




7653 


0013 


space 


space 


55 


55 


0040 




FF 




7654 


0014 


, coma 


, comma 


56 


56 


0054 




CR 




7655 


0015 


. period 


. period 


57 


57 


0056 




SO 




7656 


0016 


# number 


# number 


60 


60 


0043 




SI 




7657 


0017 


f I. bracket 


T. 1. bracket 


61 


61 


0133 




DEL 




7637 


0177 


1 r. bracket 


3 r. bracket 


62 


62 


0135 




DLE 




7660 


0020 


X percent™ 


X percent™ 


63™ 


63™ 


0045 




DC1 




7661 


0021 


" quote 


" quote 


64 


64 


0042 




DC2 




7662 


0022 


_ underline 


_ underline 


65 


65 


0137 




DC3 




7663 


0023 


! exclam. 


! exclam. 


66 


66 


0041 




DC4 




7664 


0024 


8 ampersand 


8 ampersand 


67 


67 


0046 




NAK 




7665 


0025 


' apostrophe 


' apostrophe 


70 


70 


0047 




SYN 




7666 


0026 


? question 


? question 


71 


71 


0077 




ETB 




7667 


0027 


< less than 


< less than 


72 


72 


0074 




CAN 




7670 


0030 


> grtr. than 


> grtr. than 


73 


73 


0076 




EH 




7671 


0031 


a coml. at 




74 








SUB 




7672 


0032 


V rev. slant 


\ rev. slant 


75 


75 


0134 




ESC 




7673 


0033 


■*■ circumflex 




76 








FS 




7674 


0034 


; semicolon 


; semicolon 


77 


77 


0073 




GS 




7675 


0035 




a coml. at 




7401 


0100 




RS 
US 




7676 
7677 


0036 
0037 


* Generally a 


vai lable only 


on N0S, 


or through 


BASIC on NOS/BE. 




™The interpr 


etation of thi 


s charac 


ter or coc 


e depends on its context. Refer to Character Set Anomali 


es in 


the text. 
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TABLE A-2. LOCAL BATCH DEVICE CHARACTER SETS 



CDC 


ASCII 


ASCII 


Octal 


Octal 


Octal 


Card Keypunch Code 


Graphic 
(64-Character 


Graphic 
(64-Character 


Graphic 
(95-Character 


6-Bit 


6/12-Bit 
Display 


12-Bit 
ASCII 






Display 


026 


029 


Set) 


Set) 


Set) 


Code 


Code 1 


Code 






: colon 11 


: co Ion ft 




oott 






8-2 


8-2 


A 


A 


A 


01 


01 


0101 


12-1 


12-1 


8 


B 


B 


02 


02 


0102 


12-2 


12-2 


C 


C 


C 


03 


03 


0103 


12-3 


12-3 


D 


D 


D 


04 


04 


0104 


12-4 


12-4 


E 


E 


E 


OS 


05 


0105 


12-5 


12-5 


F 


F 


F 


06 


06 


0106 


12-6 


12-6 


G 


G 


G 


07 


07 


0107 


12-7 


12-7 


H 


H 


H 


10 


10 


0110 


12-8 


12-8 


I 


I 


I 


11 


11 


0111 


12-9 


12-9 


J 


J 


J 


12 


12 


0112 


11-1 


11-1 


K 


K 


K 


13 


13 


0113 


11-2 


11-2 


L 


L 


L 


14 


14 


0114 


11-3 


11-3 


N 


N 


n 


15 


15 


0115 


11-4 


11-4 


N 


N 


N 


16 


16 


0116 


11-5 


11-5 











17 


17 


0117 


11-6 


11-6 


P 


P 


p 


20 


20 


0120 


11-7 


11-7 


a 


Q 


Q 


21 


21 


0121 


11-8 


11-8 


R 


R 


R 


22 


22 


0122 


11-9 


11-9 


s 


S 


S 


23 


23 


0123 


0-2 


0-2 


T 


T 


T 


24 


24 


0124 


0-3 


0-3 


U 


U 


U 


25 


25 


0125 


0-4 


0-4 


V 


V 


V 


26 


26 


0126 


0-5 


0-5 


w 


w 


w 


27 


27 


0127 


0-6 


0-6 


X 


X 


X 


30 


30 


0130 


0-7 


0-7 


Y 


Y 


Y 


31 


31 


0131 


0-8 


0-8 


Z 


z 


z 


32 


32 


0132 


0-9 


0-9 











33 


33 


0060 








1 


1 


1 


34 


34 


0061 


1 


1 


2 


2 


2 


35 


35 


0062 


2 


2 


3 


3 


3 


36 


36 


0063 


3 


3 


4 


4 


4 


37 


37 


0064 


4 


4 


5 


5 


5 


40 


40 


0065 


5 


5 


6 


6 


6 


41 


41 


0066 


6 


6 


7 


7 


7 


42 


42 


0067 


7 


7 


8 


8 


8 


43 


43 


0070 


8 


8 


9 


9 


9 


44 


44 


0071 


9 


9 


+ plus 


+ plus 


+ plus 


45 


45 


0053 


12 


12-8-6 


- minus 


- minus 


- minus 


46 


46 


0055 


11 


11 


* asterisk 


* asterisk 


* asterisk 


47 


47 


0052 


11-8-4 


11-8-4 


/ slash 


/ slash 


/ slash 


50 


50 


0057 


0-1 


0-1 


( left paren. 


( left paren. 


( left paren. 


51 


51 


0050 


0-8-4 


12-8-5 


) right paren. 


) right paren. 


) right paren. 


52 


52 


0051 


12-8-4 


11-8-5 


$ dollar 


$ dollar 


$ dollar 


53 


53 


0044 


11-8-3 


11-8-3 


= equal to 


= equal to 


= equal to 


54 


54 


0075 


8-3 


8-6 


space 


space 


space 


55 


55 


0040 


no punch 


no punch 


r comma 


, comma 


, comma 


56 


56 


0054 


0-8-3 


0-8-3 


. period 


. period 


. period 


57 


57 


0056 


12-8-3 


12-8-3 


= equivalence 


ft number 


# number 


60 


60 


0043 


0-8-6 


8-3 


C left bracket 


C left bracket 


CI. bracket 


61 


61 


0133 


8-7 


or 12-0 m 


] right bracket 


3 right bracket 


3 r. bracket 


62 


62 


0135 


0-8-2 


11-8-2 
or 11-0 m 


X percent 11 ' 


X percent 11 


X percent 11 


63 n 


63" 


0045 


8-6 


0-8-4 
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TABLE A-2. LOCAL BATCH DEVICE CHARACTER SETS (Contd) 



CDC 


ASCII 


ASCII 


Octal 


Octal 


Octal 


Card Keypunch Code 


Graphic 
(64-Character 


Graphic 
(64-Character 


Graphic 
(95-Character 


6-Bit 


6/12-Bit 


12-Bit 






Display 


Display 


ASCII 


026 


029 


Set) 


Set) 


Set) 


Code 


Code* 


Code 






# not equal 


" quote 


" quote 


64 


64 


0042 


8-4 


8 ~ 7 8 


r*concat. 


_ underline 


_ underline 


65 


65 


0137 


0-8-5 


0-8-55 
or 
11-0 


V logical OR 


! exclamation 


! exclamation 


66 


66 


0041 


11-0§ 
or 
11-8-2 


12-8-7 


A logical AND 


8 ampersand 


8 ampersand 


67 


67 


0046 


0-8-7 


12 


t superscript 


' apostrophe 


' apostrophe 


70 


70 


0047 


11-8-5 


8-5 


4 subscript 


? question 


? question 


71 


71 


0077 


11-8-6 


0-8-7 


< less than 


< less than 


< less than 


72 


72 


0074 


12-0 


12-8-4 


> greater than 


> greater than 


> greater than 


73 


73 


0076 


11-8-7 


0-8-6 


< less/equal 


a commercial at 




74 






8-5 


8-4 


>_ greater/equal 


\ reverse slant 


\ rev. slant 


75 


75 


0134 


12-8-5 


0-8-2 


—i logical MOT 


circumflex 




76 






12-8-6 


11-8-7 


; semicolon 


; semi colon 


; seai colon 

a coal, at 

■*• circumflex 

: colon 

* grave accent 

a 

b 

c 

d 

e 
f 

9 

h 
1 
J 

k 


77 


77 
7401 
7402 
7404 
7407 
7601 
7602 

7603 
7604 
7605 
7606 
7607 
7610 
7611 
7612 

7613 


0073 
0100 
0136 
0072 
0140 
0141 
0142 

0143 
0144 
0145 
0146 
0147 
0150 
0151 
0152 

0153 


12-8-7 


11-8-6 






I 




7614 


0154 










a 




7615 


0155 










n 




7616 


0156 















7617 


0157 










P 




7620 


0160 










q 




7621 


0161 










r 




7622 


0162 










s 




7623 


0163 










t 




7624 


0164 










u 




7625 


0165 










V 




7626 


0166 










u 




7627 


0167 










X 




7630 


0170 










y 




7631 


0171 










z 




7632 


0172 










< left brace 




7633 


0173 










| vert, line 




7634 


0174 










> right brace 




7635 


0175 










- tilde 




7636 


0176 






'''Generally ava 


i lable only on NOS/or through BASIC 


on NOS/BE. 










ft The interpret 


ation of this character or code depen 


is on its c 


ontext . Ref 


er to Chara 


cter Set Ar 


toaalies 


in the text. 














m Available for 


input only, on NOS. 












§ Avai lable for 


input only, on NOS/BE. 
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Local Batch Users 

Table A-2 lists the CDC graphic 64-character set, 
the ASCII graphic 64-character set, and the ASCII 
graphic 95-character set. This table also lists 
the code sets and card keypunch codes (026 and 029) 
that represent the characters. 

The 64-character sets use display code as their 
code set; the 95-character set uses 12-bit ASCII 
code. The 95-character set is composed of all the 
characters in the ASCII 128-character set that can 
be printed at a line printer (refer to Line Printer 
Output). Only 12-bit ASCII code files can be 
printed using the ASCII graphic 95-character set. 
To print a 6/12-bit display code file (usually 
created in IAF ASCII mode) , you must convert the 
file to 12-bit ASCII code. To do this, the NOS 
FCOPY control statement must be issued. The 
95-character set is represented by the 12-bit ASCII 
codes 0040g through 0176g. 



Line Printer Output 

The batch character set printed depends on the 
print train used on the line printer to which the 
file is sent. The following are the print trains 
corresponding to each of the batch character sets: 



Character Set 



CDC graphic 64-character set 
ASCII graphic 64-character set 
ASCII graphic 95-character set 



Print 
Train 

596-1 

596-5 

596-6 



The characters of the default 596-1 print train are 
listed in the table A-2 column labeled CDC Graphic 
(64-Character); the 596-5 print train characters 
are listed in the table A-2 column labeled ASCII 
Graphic (64-Character); and the 596-6 print train 
characters are listed in the table A-2 column 
labeled ASCII Graphic (95-Character). 

If a transmission error occurs during the printing 
of a line, NOS prints the line again. The CDC 
graphic print train prints a concatenation symbol 
(l - *) In the first printable column of a line 
containing errors. The ASCII print trains print an 
underline instead of the concatenation symbol. 

If an unprintable character exists in a line (that 
is, a 12-bit ASCII code outside of the range 
0040 8 through 0176s), the number sign (#) 
appears in the first printable column of a print 
line and a space replaces the unprintable character. 



Punched Card Input and Output 

Under NOS, coded character data is exchanged with 
local batch card readers or card punches according 
to the translations shown in table A-2. As indi- 
cated in the table, additional card keypunch codes 
are available for input of the ASCII and CDC char- 
acters [ and ] . The 95-character set cannot be 
read or punched as coded character data. 



Depending on an installation or deadstart option, 
NOS assumes an input deck • has been punched either 
in 026 or 029 keypunch code (regardless of the 
character set in use). The alternate keypunch 
codes can be specified by a 26 or 29 punched in 
columns 79 and 80 of any job card, 6/7/9 card, or 
7/8/9 card. The specified code translation remains- 
in effect throughout the job unless it is reset by 
specification of the alternate code translation on 
a subsequent 6/7/9 card or 7/8/9 card. 

NOS keypunch code translation can also be changed 
by a card containing a 5/7/9 punch in column 1. A 
blank (no punch) in column 2 indicates 026 conver- 
sion mode; a 9 punch in column 2 indicates 029 
conversion mode. The conversion change remains in 
effect until another change card is encountered or 
the job ends. 

The 5/7/9 card also allows literal input when 
4/5/6/7/8/9 is punched in column 2. Literal input 
can be used to read 80-column binary character data 
within a punched card deck of coded character data. 

Literal cards are stored with each column in a 
12-bit byte (a row 12 punch is represented by a 1 
in bit 11, row 11 by bit 10, row by bit 9, and 
rows 1 through 9 by bits 8 through of the byte), 
16 central memory words per card. Literal input 
cards are read until a card identical to the pre- 
vious 5/7/9 card (4/5/6/7/8/9 in column 2) is 
read. The next card can specify a new conversion 
mode. 

Under N0S/BE, coded character data is exchanged 
with local batch card readers or card punches 
according to the translations shown in table A-2. 
As indicated in the table, additional card keypunch 
codes are available for input of the CDC characters 
V and < or their ASCII equivalents ! and <• The 
95-character set cannot be read or punched as coded 
character data. 

Depending on an installation option, NOS/BE assumes 
an input deck has been punched either in 026 or in 
029 keypunch code (regardless of the character set 
in use). The alternate keypunch codes can be 
specified by a 26 or 29 punched in columns 79 and 
80 of the job statement or in columns 79 and 80 of 
any 7/8/9 card. The specified code translation 
remains in effect throughout the job unless it is 
reset by specification of the alternate code 
translation on a subsequent 7/8/9 card. 

Under NOS/BE, a card with all of column 1 punched 
(that is, 12 punches in column 1) and all of one 
other column punched can be followed by 80-column 
cards of free-form binary data. These binary data 
cards are read or punched as described for NOS 
literal data until another card with 12 punches in 
column 1 and in one other column occurs, or until 
the job ends. The next card is interpreted as 
coded data. 



Remote Batch Users 

When card decks are read from remote batch devices, 
the ability to select alternate keypunch code 
translations depends upon the remote terminal 
equipment. 
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NOS Usage 

Remote batch terminal line printer, punched card, 
and plotter character set support Is described in 
the Remote Batch Facility (RBF) reference manual. 
RBF supports only character mode transmission to 
and from consoles through the network. Character 
mode is described under Network Access Method 
Terminal Transmission Code Sets in this appendix. 



NOS /BE Usage 

The remote batch terminal line printer, punched 
card, and plotter character set support is de- 
scribed in the INTERCOM reference manual. 



Magnetic Tape Users 

Coded character data to be copied from mass storage 
to magnetic tape Is assumed to be represented in 
display code. NOS converts the data to external 
BCD code when writing a coded 7-track tape and to 
ASCII or EBCDIC code (as specified on the tape 
assignment statement) when writing a coded 9-track 
tape. 

Because only 63 characters can be represented in 
7-track even parity, one of the 64 display codes is 
lost in conversion to and from external BCD code. 
Figure A-l shows the differences in conversion that 
depend on which character set (63 or 64) the system 
uses. The ASCII character for the specified char- 
acter code is shown in parentheses. The output 
arrow shows how the display code changes when it is 
written on tape in external BCD. The input arrow 
shows how the external BCD code changes when the 
tape is read and converted to display code. 



Display Code 


63-Character Set 

External BCD 

16(%) 

Output 1 2(0) 

12(0) 

64-Character Set 

External BCD 

12(0) 

Output 12(0) 

" 16(%) 


Input 


Display Code 


00 

33(0) 
63(:) 

Display Code 


00 

33(0) 
' 33(0) 

Display Code 


Input 


00(:» 
33(0) 
63(%) 


33(0) 
33(0) 
63(%) 



Figure A-1. Magnetic Tape Code Conversions 

Tables A-3 and A-4 show the character set conver- 
sions for 9-track tapes. Table A-3 lists the 
conversions to and from 7-bit ASCII character code 
and 6-bit display code. Table A-4 lists the 
conversions between 8-bit EBCDIC character code and 
6-bit display code. Table A-5 shows the character 
set conversions between 6-bit external BCD and 
6-bit display code for 7-track tapes. 

If a lowercase ASCII or EBCDIC code is read from a 
9-track coded tape, it is converted to its upper- 
case 6-bit display code equivalent. To read and 
write lowercase ASCII or EBCDIC characters, the 



user must assign the tape in binary mode and then 
convert the binary character, data. 

During binary character data transfers to or from 
9-track magnetic tape, the 7-bit ASCII codes shown 
in table A-6 are read or written unchanged; the 
8-bit hexadecimal EBCDIC codes shown in table A- 7 
also can be read or written unchanged. ASCII and 
EBCDIC codes cannot be read or written to 7-track 
magnetic tape as binary character data. 

Two CDC utility products, FORM and the 8-Bit Sub- 
routines, can be used to convert to and from EBCDIC 
data. Table A- 7 contains the octal values of each 
EBCDIC code right-justified in a 12-bit byte with 
zero fill. This 12-bit EBCDIC code can also be 
produced using FORM and the 8-Bit Subroutines. 

NETWORK ACCESS METHOD TERMINAL 
TRANSMISSION CODE SETS 

There are two modes in which coded character data 
can be exchanged with a network terminal console. 
These two modes, character mode and transparent 
mode, correspond to the type of character code 
editing and translation performed by the network 
software during input and output operations. The 
transmission mode used by the network software for 
input can be selected by the terminal operator, 
using a Terminal Interface Program command 
(sometimes referred to as a terminal definition 
command). The transmission mode used by the 
network software for output can be selected by the 
application program providing the terminal facility 
service. 



Character Mode Transmissions 

Character mode is the initial and default mode used 
for both input and output transmissions. When the 
network software services the terminal in character 
mode, it translates input characters from the 
transmission code used by the terminal into the 
ASCII code shown in table A-6. The translation of 
a specific transmission code to a specific ASCII 
code depends on the terminal class the network 
software associates with the terminal. In char- 
acter mode input, the parity of the terminal 
transmission code is not preserved in the corres- 
ponding ASCII code; the ASCII code received by the 
terminal-servicing facility program always has its 
eighth bit set to zero. 

Character mode output is translated in a similar 
manner. The network software provides the parity 
bit setting appropriate for the terminal being 
serviced, even though translating from ASCII char- 
acters with zero parity bit settings. 

The general case for code translations of character 
mode data is summarized in the following para- 
graphs. This generalized description permits use 
of only table A-6 to explain all specific cases. 
You can logically extend this generalized descrip- 
tion to allow use of tables A-l through A-5 as 
descriptions of character set mapping for various 
functions Initiated from a terminal. Tables A-l 
through A-5 are provided for your use while coding 
an application program to run under the operating 
system. They do not describe character trans- 
missions between an application program and the 
network. 
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TABLE A-3. ASCII 9-TRACK CODED TAPE CONVERSION 



ASCII 






ASCII 










Display 






Display 


Code 


Character and 


Code*** 


Code 


Character and 


Code*** 


Conversion' 


Code Conversion** 




Conversion* 


Code Conversion** 




Code 


Char 


Code 


Char 


ASCII 


Code 


Code 


Char 


Code 


Char 


ASCII 


Code 


(Hex) 


(Hex) 


Char 


(Octal) 


(Hex) 


(Hex) 


Char 


(Octal) 


20 


space 


00 


NUL 


space 


55 


40 


a 


60 


• 


a 


74 


21 


; 


70 


> 


i 


66 


41 


A 


61 


a 


A 


01 


22 


ii 


02 


STX 


ii 


64 


42 


B 


62 


b 


B 


02 


23 


n 


03 


ETX 


n 


60 


43 


C 


63 


c 


C 


03 


24 


$ 


04 


EOT 


$ 


53 


44 


D 


64 


d 


D 


04 


25 


X 


05 


EM 


X 


63 


45 


E 


65 


e 


E 


05 


25 


X 


05 


ENQ 


space 


55 


46 


F 


66 


f 


F 


06 


26 


& 


06 


ACK 


8 


67 


47 


G 


67 


g 


G 


07 


27 


■ 


07 


BEL 


• 


70 


48 


H 


68 


h 


H 


10 


28 


( 


08 


BS 


€ 


51 


49 


I 


69 


i 


I 


11 


29 


) 


09 


HT 


) 


52 


4A 


J 


6A 


J 


J 


12 


2A 


* 


0A 


LF 


* 


47 


4B 


K 


6B 


k 


K 


13 


2B 


+ 


0B 


VT 


+ 


45 


4C 


L 


6C 


I 


L 


14 


2C 


t 


0C 


FF 


f 


56 


4D 


N 


6D 


ID 


N 


15 


2D 


- 


0D 


CR 


- 


46 


4E 


N 


6E 


n 


N 


16 


2E 


. 


0E 


SO 


. 


57 


4F 





6F 


o 





17 


2F 


/ 


OF 


SI 


/ 


50 


50 


P 


70 


P 


P 


20 


30 





10 


DLE 





33 


51 


Q 


71 


q 


9 


21 


31 


1 


11 


DC1 


1 


34 


52 


R 


72 


r 


R 


22 


32 


2 


12 


DC2 


2 


35 


53 


S 


73 


s 


S 


23 


33 


3 


13 


DC3 


3 


36 


54 


T 


74 


t 


T 


24 


34 


4 


14 


DC4 


4 


37 


55 


U 


75 


u 


U 


25 


35 


5 


15 


NAK 


5 


40 


56 


V 


76 


V 


V 


26 


36 


6 


16 


SYN 


6 


41 


57 


u 


77 


w 


w 


27 


37 


7 


17 


ETB 


7 


42 


58 


X 


78 


x 


X 


30 


38 


8 


18 


CAN 


8 


43 


59 


Y 


79 


y 


Y 


31 


39 


9 


19 EM 


9 


44 


5A 


z 


7A 


z 


z 


32 


3A 


: 


1A I SUB 


: 


00 


5B 


c 


1C 


FS 


c 


61 


Display code 00 is undefined at sites using the 


5C 


\ 


7C 


I 


\ 


75 


63-character set. 


5D 


c 


01 


S0H 


1 


62 


3A 


: 


1A 


SUB 


: 


63 


5E 


A 


7E 


- 


X 


76 


3B 


r 


1B 


ESC 


r 


77 


5F 




7F 


DEL 




65 


3C 


< 


7B 


< 


< 


72 














3D 


= 


1D 


SS 


= 


54 














3E 


> 


1E 


RS 


> 


73 














3F 


7 


1F 


US 


7 


71 


I 










*When these characters are copied from or to a tape/ 


the characters remain the same and the code changes 


from/to ASCII to/from display code. 








**These characters do not exist in display code. Wher 


i the characters 


are copied from a tape, each ASCII 


character is changed to an alternate display code character. The corresponding codes are also changed. 


Example: When the system copies a lowercase a, 61^ 


,, from tape, it 


writes an uppercase 


A, 01 8 . 


'*A display code space always translates to an ASCII s 


space. 







Table A-6 contains the ASCII 128-character set 
supported by the Network Access Method. A 96- 
character subset consists of the rightmost six 
columns and includes the 95-character graphic 
subset referenced previously in this appendix; the 
deletion character (DEL) is not a graphic char- 
acter. A 64-character subset consists of the 
middle four columns. Note that 6-bit display code 
equivalents exist for the characters in this 64- 
character subset only. 



Although the network supports the 128-character 
set, some terminals restrict output to a smaller 
subset. This restriction is supported by replacing 
the control characters in columns and 1 of table 
A-6 with blanks to produce the 96-character subset, 
and, additionally, replacing the characters in 
columns 6 and 7 with the corresponding characters 
from columns 4 and 5, respectively, to produce the 
64-character subset. 
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TABLE A-4. EBCDIC 9-TRACK CODED TAPE CONVERSION 



EBCDIC 






EBCDIC 






Code 


Character and 


Display 

Code+tt 


Code 


Character and 


Display 

Codettt 


Conversion 1 


Code Conversion 11 


Conversion 1 ' 


Code Conversion 11 




Code 




Code 


Char 


ASCII 


Code 


Code 


Char 


Code 


Char 


ASCII 


Code 


(Hex) 


Char 


(Hex) 


Char 


(Octal) 


(Hex) 


(Hex) 


Char 


(Octal) 


40 


space 


00 


NUL 


space 


55 


C6 


F 


86 


f 


F 


06 


4A 


t 


1C 


IFS 


C 


61 


C7 


6 


87 


9 


G 


07 


4B 


m 


0E 


SO 


. 


57 


C8 


H 


88 


h 


H 


10 


4C 


< 


CO 


< 


< 


72 


C9 


I 


89 


i 


I 


11 


4D 


( 


16 


BS 


( 


51 


D1 


J 


91 


j 


J 


12 


4E 


+ 


0B 


VT 


+ 


45 


D2 


K 


92 


k 


K 


13 


4F 


I 


DO 


> 


i 


66 


D3 


L 


93 


I 


L 


14 


50 


& 


2E 


ACK 


& 


67 


D4 


H 


94 


m 


H 


15 


5A 


j 


01 


SOH 


3 


62 


D5 


N 


95 


n 


N 


16 


SB 


$ 


37 


EOT 


$ 


53 


D6 





96 








17 


5C 


* 


25 


LF 


* 


47 


D7 


P 


97 


P 


P 


20 


5D 


) 


05 


HT 


) 


52 


D8 


9 


98 


q 


Q 


21 


SE 


w 


27 


ESC 


# 


77 


D9 


R 


99 


r 


R 


22 


5F 


—I 


A1 


•• 


/ 


76 


EO 


\ 


6A 


I 


\ 


75 


60 


- 


OD 


CR 


- 


46 


E2 


S 


A2 


s 


S 


23 


61 


« 


OF 


SI 


• 


50 


E3 


T 


A3 


t 


T 


24 


6B 


t 


OC 


FF 


t 


56 


E4 


U 


A4 


u 


U 


25 


6C 


X 


2D 


ENQ 


X 


63 


E5 


V 


A5 


V 


V 


26 


6C 


X 


2D 


ENS 


space 


55 


E6 


w 


A6 


w 


w 


27 


6D 




07 


DEL 




65 


E7 


X 


A7 


X 


X 


30 


6E 


> 


1E 


IRS 


> 


73 


E8 


Y 


A8 


y 


Y 


31 


6F 





1F 


IUS 


9 


71 


E9 


z 


A9 


z 


z 


32 


7A 


: 


3F 


SUB 


: 


00 


FO 





10 


DLE 





33 


Display code 00 is undefined at sites using the 


F1 


1 


11 


DC1 


1 


34 


63-character set. 


F2 


2 


12 


DC2 


2 


35 


7A 


: 


3F 


SUB 


: 


63 


F3 


3 


13 


TM 


3 


36 


7B 


# 


03 


ETX 


# 


60 


F4 


4 


3C 


DC4 


4 


37 


7C 


a 


79 


\ 


a 


74 


F5 


5 


3D 


NAK 


5 


40 


7D 


I 


2F 


BEL 


■ 


70 


F6 


6 


32 


SYN 


6 


41 


7E 


s 


1D 


IBS 


= 


54 


F7 


7 


26 


ETB 


7 


42 


7F 


■■ 


02 


STX 


ii 


64 


F8 


8 


18 


CAN 


8 


43 


C1 


A 


81 


a 


A 


01 


F9 


9 


19 


EH 


9 


44 


C2 


B 


82 


b 


B 


02 














C3 


C 


83 


c 


C 


03 














C4 


D 


84 


d 


D 


04 














C5 


E 


85 


e 


E 


05 














^All EBCDIC codes not listed translate to display code 55g Cspace) . 


A display code space 


a Iways 


translates to an EBCDIC space. 






^These characters do not exist in display code. When the characters 


are copied from a tape, each EBCDIC 


character is changed to an alternate display code character. The co 


rresponding codes are 


> also changed. 


Example: When the system copies a lowercase a, 81 1 , from tape, it 


writes an uppercase A, 01g. 


^When these characters are copied from or to a tape, the characters remain the same (except EBCDIC codes 


4*16/ * F 16' 5 *16^ and 5F 16> and the code changes from/to EBCDIC to/f 


rom display code. 





Similarly, input from a device may be limited to a 
smaller subset by the device itself because the 
device cannot produce the full 128-character set. 
A character input from a device using a character 
set other than ASCII is converted to an equivalent 
ASCII character; characters without ASCII character 
equivalents are replaced by the ASCII blank char- 
acter. 



An application can also cause character replacement 
(as described previously for output) as well as 
character conversion, by requesting display-coded 
input from the network.. 

The 7-bit hexadecimal code value for each character 
consists of the character's column number in the 
table, followed by its row number. For example, N 
is in row E of column 4, so its value is 4E}£. 
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TABLE A-5. 7-TRACK CODED TAPE CONVERSIONS 



External 


ASCII 


Octal Display 


External 


ASCII 


Octal Display 


BCD 


Character 


Code 


BCD 


Character 


Code 


01 


1 


34 


40 


_ 


46 


02 


2 


35 


41 


J 


12 


03 


3 


36 


42 


K 


13 


04 


4 


37 


43 


L 


14 


05 


5 


40 


44 


H 


15 


06 


6 


41 


45 


N 


16 


07 


7 


42 


46 





17 


10 


8 


43 


47 


P 


20 


11 


9 


44 


50 


Q 


21 


12t 





33 


51 


R 


22 


13 


= 


54 


52 


! 


66 


14 


tt 


64 


53 


$ 


53 


15 


a 


74 


54 


* 


47 


16t 


X 


63 


55 


■ 


70 


17 


r. 


61 


56 


1 


71 


20 


space 


55 


57 


> 


73 


21 


/ 


50 


60 


+ 


45 


22 


S 


23 


61 


A 


01 


23 


T 


24 


62 


B 


02 


24 


U 


25 


63 


C 


03 


25 


V 


26 


64 


D 


04 


26 


u 


27 


65 


E 


05 


27 


X 


30 


66 


F 


06 


30 


Y 


31 


67 


6 


07 


31 


z 


32 


70 


H 


10 


32 


3 


62 


71 


I 


11 


33 


r 


56 


72 


< 


72 


34 


< 


51 


73 


* 


57 


35 




65 


74 


) 


52 


36 


7 


60 


75 


\ 


75 


37 


t 


67 


76 


a 


76 








77 


/ 


77 


*As explained in the text of 


this appendix, convers 


ion of these code 


s depends on whether the tape is 


being read or written. 











Transparent Mode Transmissions 

Transparent mode is selected separately for input 
and output transmissions. During transparent mode 
input, the parity bit is stripped from each ter- 
minal transmission code (unless the N parity option 
has been selected by a Terminal Interface Program 
command) , and the transmission code is placed in an 
8-bit byte without translation to 7-bit ASCII 
code. Line transmission protocol characters are 
deleted from a mode AC terminal input stream. 



When the 8-bit bytes arrive in the host computer, a 
terminal servicing facility program such as the 
Interactive Facility can right-justify the bytes 



within a 12-bit byte. Upon transmission of 12-bit 
bytes from the host computer, the leftmost 4 bits 
(bits 11 through 8) are discarded. 

During transparent mode output, processing similar 
to that performed for input occurs. The code in 
each 8-bit byte received by the network software 
from the terminal servicing facility program is not 
translated. The parity bit appropriate for the 
terminal class being used is altered as indicated 
by the parity option in effect for the terminal. 
The codes are then output in transmission bytes 
appropriate for the codes associated with the 
terminal class being used. Line transmission 
protocol characters are inserted into a mode 4C 
terminal output stream. 
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TABLE A-6. FULL ASCII CHARACTER SET 



-128-Character Set- 



-96-Character Subset - 



-64-Character Subset- 












1 



1 





1 
1 


1 




1 

1 


1 
1 




1 
1 
1 


7 1 












6 h 












b 5 
Bits 


b 4 


b 3 

I 


b 2 
* 


b 1 
\ 




>v Column 





1 


2 


3 


4 


5 


6 


7 


Row V^ "■' 

















NUL 
000 


DLE 
020 


SP 

040 



060 


a 

100 


P 
120 


140 


P 
160 













1 


1 


SOH 
001 


DC1 
021 


i 
041 


1 
061 


A 
101 


Q 
121 


a 
141 


q 
161 










1 





2 


STX 

002 


DC2 
022 


II 

042 


2 

062 


B 
102 


R 
122 


b 
142 


r 
162 










1 


1 


3 


ETX 
003 


DC3 
023 


043 


3 

063 


C 
103 


S 
123 


c 
143 


s 
163 







1 








4 


EOT 
004 


DC4 
024 


$ 

044 


4 
064 


D 
104 


T 
124 


d 
144 


t 
164 







1 





1 


5 


ENQ 
005 


NAK 
025 


X 
045 


5 
065 


E 
105 


U 
125 


e 
145 


u 
165 







1 


1 





6 


ACK 
006 


SYN 
026 


& 
046 


6 
066 


F 

106 


V 
126 


f 
146 


V 

166 







1 


1 


1 


7 


BEL 
007 


ETB 
027 


1 

047 


7 
067 


G 
107 


W 
127 


9 
147 


w 
167 















8 


BS 

010 


CAN 
030 


( 
050 


8 

070 


H 
110 


X 
130 


h 
150 


X 

170 












1 


9 


HT 
011 


EN 
031 


) 
051 


9 
071 


I 
111 


Y 
131 


i 
151 


y 

171 









1 





A 


LF 
012 


SUB 
032 


* 
052 


072 


J 
112 


Z 
132 


J 
152 


z 
172 









1 


1 


B 


VT 
013 


ESC 
033 


+ 
053 


073 


K 
113 


C 
133 


k 
153 


< 
173 






1 








C 


FF 
014 


FS 
034 


054 


< 

074 


L 
114 


\ 
134 


I 
154 


I 
174 






1 





1 


D 


CR 
015 


GS 

035 


055 


075 


N 
115 


3 
135 


m 
155 


> 
175 






1 


1 





E 


SO 

016 


RS 
036 


056 


> 

076 


N 
116 


A 

136 


n 
156 


176 






1 


1 


1 


F 


SI 
017 


US 
037 


1 
057 


7 
077 



117 


137 




157 


DEL 

177 


LEGEND: 
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TABLE A-7. FULL EBCDIC CHARACTER SET 



Hexa- 
decimal 
EBCDIC 
Code 



Octal 
12-Bit 
EBCDIC 
Code 



EBCDIC 
Graphic 
Character* 



EBCDIC 

Control 

Character 



Hexa- 
decimal 
EBCDIC 
Code 



Octal 

12-Bit 

EBCDIC 

Code 



EBCDIC 
Graphic 
Character* 



EBCDIC 

Control 

Character 



00 


0000 


01 


0001 


02 


0002 


OS 


0003 


04 


0004 


05 


0005 


06 


0006 


07 


0007 


08 


0010 


09 


0011 


OA 


0012 


OB 


0013 


OC 


0014 


OD 


0015 


OE 


0016 


OF 


0017 


10 


0020 


11 


0021 


12 


0022 


13 


0023 


14 


0024 


15 


0025 


16 


0026 


17 


0027 


18 


0030 


19 


0031 


1A 


0032 


1B 


0033 


1C 


0034 


1D 


0035 


1E 


0036 


1F 


0037 


20 


0040 


21 


0041 


22 


0042 


23 


0043 


24 


0044 


25 


0045 


26 


0046 


27 


0047 


28 


0050 


29 


0051 


2A 


0052 


2B 


0053 


2C 


0054 


2D 


0055 


2E 


0056 


2F 


0057 


30 


0060 


31 


0061 


32 


0062 


33 


0063 


34 


0064 


35 


0065 


36 


0066 


37 


0067 


38 


0070 


39 


0071 


3A 


0072 


3B 


0073 


3C 


0074 


3D 


0075 


3E 


0076 


3F 


0077 


40 


0100 



space 



NUL 

SOH 

STX 

ETX 

PF 

HT 

LC 

DEL 

undefined 

undefined 

SMR 

VT 

FF 

CR 

SO 

SI 

DLE 

DC1 

DC2 

TH 

RES 

ML 

BS 

IL 

CAN 

EN 

CC 

CU1 

IFS 

IGS 

IRS 

IUS 

DS 

SOS 

FS 

undefined 

BYP 

LF 

ETB or EOB 

ESC or PRE 

undefined 

undefined 

SH 

CU2 

undefined 

ENQ 

ACK 

BEL 

undefined 

undefined 

SYN 

undefined 

PN 

RS 

UC 

EOT 

undefined 

undefined 

undefined 

CU3 

DC4 

NAK 

undefined 

SUB 



41 

thru 

49 

4A 

4B 

4C 

4D 

4E 

4F 

50 

51 

thru 

59 

5A 

5B 

5C 

5D 

5E 

5F 

60 

61 

62 

thru 

69 

6A 

6B 

6C 

6D 

6E 

6F 

70 

thru 

78 

79 

7A 

7B 

7C 

7D 

7E 

7F 

80 

81 

82 

83 

84 

85 

86 

87 

88 

89 

8A 

thru 

90 

91 

92 

93 

94 

95 

96 

97 

98 

99 

9A 

thru 

AO 



0101 

thru 

0111 

0112 

0113 

0114 

0115 

0116 

0117 

0120 

0121 

thru 

0131 

0132 

0133 

0134 

0135 

0136 

0137 

0140 

0141 

0142 

thru 

0151 

0152 

0153 

0154 

0155 

0156 

0157 

0160 

thru 

0170 

0171 

0172 

0173 

0174 

0175 

0176 

0177 

0200 

0201 

0202 

0203 

0204 

0205 

0206 

0207 

0210 

0211 

0212 

thru 

0220 

0221 

0222 

0223 

0224 

0225 

0226 

0227 

0230 

0231 

0232 

thru 

0240 



undefined 



undefined 



undefined 



k 
I 
m 
n 
o 
P 
q 
r 



undefined 



undefined 



undefined 



undefined 
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TABLE A-7. FULL EBCDIC CHARACTER SET (Contd) 



Hexa- 
decimal 
EBCDIC 
Code 


Octal 
12-Bit 
EBCDIC 
Code 


EBCDIC 
Graph 1 c 
Character 1 ' 


EBCDIC 

Control 

Character 


Hexa- 
decimal 
EBCDIC 
Code 


Octal 
12-Bit 
EBCDIC 
Code 


EBCDIC 
Graph i c 
Character* 


EBCDIC 

Control 

Character 


A1 


0241 


- 




D7 


0327 


P 




A2 


0242 


s 




D8 


0330 


a 




A3 


0243 


t 




D9 


0331 


R 




A4 


0244 


u 




DA 


0332 




undefined 


A5 


024S 


V 




thru 


thru 






A6 


0246 


w 




DF 


0337 






A7 


0247 


X 




EO 


0340 


\ 




A8 


0250 


y 




E1 


0341 




undefined 


A9 


0251 


z 




E2 


0342 


s 




AA 


0252 




undefined 


E3 


0343 


T 




thru 


thru 






E4 


0344 


U 




BF 


0277 






E5 


0345 


V 




CO 


0300 


< 




E6 


0346 


u 




C1 


0301 


A 




E7 


0347 


X 




C2 


0302 


B 




E8 


0350 


Y 




C3 


0303 


C 




E9 


0351 


z 




C4 


0304 


D 




EA 


0352 




undefined 


C5 


0305 


E 




EB 


0353 




undefined 


C6 


0306 


F 




EC 


0354 


H 




C7 


0307 


6 




ED 


0355 




undefined 


C8 


0310 


H 




thru 


thru 






C9 


0311 


I 




EF 


0357 






CA 


0312 




undefined 


FO 


0360 







CB 


0313 




undefined 


F1 


0361 


1 




CC 


0314 


t 




F2 


0362 


2 




CD 


0315 


V 


undefined 


F3 


0363 


3 




CE 


0316 






F4 


0364 


4 




CF 


0317 




undefined 


F5 


0365 


5 




DO 


0320 


> 




F6 


0366 


6 




01 


0321 


J 




F7 


0367 


7 




D2 


0322 


K 




F8 


0370 


8 




D3 


0323 


L 




F9 


0371 


9 




D4 


0324 


N 




FA 


0372 


I 




D5 


0325 


N 




FB 


0373 




undefined 


D6 


0326 







thru 
FF 


thru 
0377 






^Graphic 


characters s 


•houn are those 


used on the IBM Systen/370 sta 


ndard (PN) p 


rint train. Other devices 


support 


subsets or v 


rar nations of th 


is character graphic set. 
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DIAGNOSTICS 



B 



Diagnostic messages that can be issued by Sort/ 
Merge are listed in table B-l. If an error occurs, 
the error level and the error number are written on 
the error file or the listing file. The diagnostic 
message is written on the next line. For errors 
numbered 1 through 40, the parameter statement that 
is in error is written on another line, and a 
pointer indicates the position of the error in the 
parameter statement. 

An error can be one of the following levels: 

T Trivial; a trivial diagnostic results from 
a usage that is syntactically correct but 
questionable. 

W Warning; a warning diagnostic results from 
a usage that is syntactically incorrect, 



but from which Sort/Merge has been able to 
recover by making an assumption about what 
was intended. 

Fatal; a fatal diagnostic results when 
Sort/Merge cannot resolve a syntactic or 
semantic error. The remaining parameter 
statements are read, but no Sort/Merge 
processing occurs. 

Catastrophic; a catastrophic error causes 
immediate Sort/Merge termination. 



Specifying the STATUS parameter or calling the 
SM5ST procedure prevents job step termination; the 
status variable indicates the highest level of 
error that occurred. 



TABLE B-l. SORT /MERGE DIAGNOSTICS 



Error 
Number 


Error 
Level 


Message 


Significance 


Action 


1 


F 


A SPACE OR , EXPECTED 


A space or a comma must sep- 
arate parameters in a control 
statement or directive file. A 
space or a comma must also sep- 
arate values in a set of values 
specified for a parameter. 


Insert a space or a comma 
between each parameter and 
between values specified 
for a parameter. 


2 


C 


CHARACTERS USED OUTSIDE 
A STRING OR NAME MUST 
BE LETTER, DIGIT ) = ( 
' , OR SPACE 


Unless in a literal string or 
in the name of a user-supplied 
entity, only alphabetic and 
numeric characters and the 
special characters ) = ( ' , 
and space are valid in a con- 
trol statement or directive 
file. 


Replace invalid characters 
with valid characters. 


3 


F 


A VALUE SHOULD FOLLOW 
THIS KEYWORD 


At least one value must be 
specified following a 
parameter keyword. 


Insert a value following 
the parameter keyword. 


4 


C 


UNDEFINED COLLATING 
SEQUENCE 


The name of a key type in a KEY 
parameter is not a predefined 
collating sequence or a se- 
quence you have defined with 
SEQx parameters. 


Change the name of the key 
type to one of the prede- 
fined collating sequences 
or a sequence you have 
defined. 


5 


F 


CHARACTER AFTER KEYWORD 
MUST BE SPACE OR - 


A parameter keyword must be 
separated from its value by an 
= or space. 


Insert an - after the 
parameter keyword. 


6 


F 


INVALID KEYWORD 
DETECTED 


The indicated keyword is not a 
valid procedure call keyword. 


Determine valid 
procedure call keywords. 


7 


F 


UNLESS IN A STRING, = 
SHOULD FOLLOW ONLY A 
KEYWORD 


Unless an • is in a literal 
string, - is only valid immedi- 
ately following a parameter 
keyword. 


Replace the invalid = with 
a valid character. 
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TABLE B-l. SORT/MERGE DIAGNOSTICS (Contd) 



Error 
Number 


Error 
Level 


Message 


Significance 


Action 


9 


F 


( ) MUST ENCLOSE A 
VALUE 


Parentheses in a control state- 
ment or directive file must 
enclose a parameter value. 


Place a parameter value 
between the parentheses. 


10 


F 


CHARACTER AFTER = MUST 
BE LETTER, DIGIT ( $ ' 
OR SPACE 


Only an alphabetic or numeric 
character or one of the special 
characters ( $ ' or space can 
follow an =. 


Replace the character fol- 
lowing the = with a valid 
character. 


11 


F 


THIS VALUE SHOULD BE A 
STRING (DELIMITED WITH 
'S) 


The indicated value must be a 
literal string enclosed in 
apostrophes. 


Enclose the indicated value 
in apostrophes. 


13 


F 


THIS COMMA SHOULD BE 
FOLLOWED BY A LETTER, 
DIGIT, SPACE , OR ( 


The indicated comma must be 
followed by an alphabetic or 
numeric character or one of the 
special characters , ( or 
space . 


Replace the character fol- 
lowing the indicated comma 
with a valid character. 


14 


F 


THIS CHARACTER MUST BE 
A LETTER, DIGIT ( ' 
SPACE OR , 


The indicated character must be 
an alphabetic or numeric char- 
acter or one of the special 
characters ( ' , or space. 


Replace the indicated char- 
acter with a valid 
character . 


15 


F 


TOO MANY PARAMETER 
POSITIONS HAVE BEEN 
SPECIFIED 


When specifying parameters by 
position rather than by key- 
word, a maximum of 31 positions 
is allowed; you have probably 
included too many commas. 


Check your control state- 
ment for excess commas. 


17 


F 


CHARACTER AFTER ) MUST 
BE SPACE ) OR , 


A right parenthesis can only be 
followed by another right 
parenthesis , a comma , or a 
space . 


Replace the invalid char- 
acter after the right 
parenthesis with a valid 
character. 


18 


F 


CHARACTER AFTER ( MUST 
BE A LETTER, DIGIT $ ' 
( OR SPACE 


A left parenthesis can only be 
followed by an alphabetic or 
numeric character, another left 
parenthesis, a $ ' or space. 


Replace the invalid char- 
acter after the left 
parenthesis with a valid 
character. 


19 


F 


THE HIGH AND LOW VALUES 
OF THIS RANGE MUST BE 
AN INTEGER, Rl, R2, R3, 
RIG, EF OR EFG 


If a range of values is speci- 
fied for the KEY, SUM, or ENR 
parameter , the high and low 
values of the range must be 
integers or the CCL variables 
Rl, R2, R3, RIG, EF, or EFG. 


Replace the invalid range 
value with an integer, Rl, 
R2, R3, RIG, EF, or EFG. 


20 


F 


THE HIGH AND LOW VALUES 
OF THIS RANGE MUST BE A 
STRING 


If the SEQS parameter specifies 
a range of values, the high and 
low values of the range must be 
literal strings enclosed in 
apostrophes . 


Replace the invalid range 
with a literal string 
enclosed in apostrophes. 


21 


F 


CHARACTER FOLLOWING AN 
INTEGER MUST BE ) . . , 
SPACE OR LETTER 


Only a ) .. (indicating a 
range of values ) , a comma , a 
space, or a letter can follow 
an integer. 


Replace the invalid char- 
acter following the integer 
with a valid character. 


22 


F 


POSITIONAL VALUES ARE 
NOT ALLOWED IN A VALUE- 
SET 


In a KEY or SUM parameter 
value-set, key or sum field 
characteristics must be speci- 
fied in the order shown in the 
parameter formats; values 
cannot be omitted and replaced 
by commas . 


In a KEY parameter, specify 
field position, length and 
type if you specify order; 
specify field position and 
length if you specify type. 
In a SUM parameter, specify 
field position, length and 
type if you specify repeti- 
tions . 
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TABLE B-l. SORT/MERGE DIAGNOSTICS (Contd) 



Error 
Number 


Error 
Level 


Message 


Significance 


Action 


23 


F 


A PERIOD CANNOT BE USED 
IN A PARAMETER-LIST 


A period is not a valid sepa- 
rator in a parameter list. 


Replace the invalid period 
with a valid separator; 
refer to the parameter 
syntax to determine valid 
separators . 


24 


F 


A RANGE IS ONLY ALLOWED 
AS A VALUE FOR ENR, KEY 
OR SUM PARAMETERS 


A range of values can be speci- 
fied only for the ENR, KEY, or 
SUM parameters; single values 
must be specified for other 
parameters . 


Replace the invalid range 
with a single value. 


25 


F 


UNLESS $CHAR(N) IS 
USED, ONLY ONE SET OF 
NESTED PARENTHESES IS 
ALLOWED 


Hare than two parentheses can 
appear together only when 
$CHAR(n) is used in a SEQS 
parameter to specify steps in a 
collating sequence. 


Delete the extra 
parentheses. 


26 


F 


UNLESS WITHIN A STRING, 
NEITHER . NOR = IS 
ALLOWED WITHIN A VALUE- 
SET 


A set of values specified for a 
parameter can contain a period 
or an = only in a literal 
string. 


Correct the syntax for the 
indicated values. 


27 


F 


THIS VALUE SHOULD BE A 
FILE OR PROC NAME 


The indicated value must be the 
name of a file or procedure. 


Use a file or procedure 
name for the indicated 
value. 


29 


F 


PARENTHESES MUST BE 
MATCHED IN THE 
PARAMETER-LIST 


If a right or left parenthesis 
appears in a parameter list, it 
must be matched in the list by 
its opposite. 


Insert the missing 
parenthesis. 


30 


F 


TOO FEW SETS GIVEN FOR 
THE KEYWORD ENDED HERE 


The indicated keyword must have 
a specific set of values speci- 
fied for it; a value or values 
are missing. 


Insert the values that must 
be specified for the 
indicated keyword. 


31 


F 


TOO MANY VALUE-SETS 
GIVEN FOR THIS KEYWORD- 
VALUE-LIST 


The indicated keyword must have 
a specific set of values 
specified for it; too many 
values have been specified. 


Determine the values that 
can be specified for the 
indicated keyword. 


32 


F 


THIS VALUE SHOULD BE AN 
INTEGER 


The indicated value must be an 
integer. 


Replace the invalid value 
with an integer value. 


33 


F 


TOO MANY VALUES 
SPECIFIED IN THIS 
VALUE-SET 


Too many values have been 
specified for the indicated set 
of values in a list of 
parameter values. 


Determine the values that 
can be specified in the 
indicated set of values. 


34 


F 


TOO FEW VALUES 
SPECIFIED IN THIS 
VALUE-SET 


Too few values have been speci- 
fied for the indicated set of 
values in a list of parameter 
values . 


Determine the values that 
can be specified in the 
indicated set of values. 


35 


F 


ONLY A , ) .. OR SPACE 
CAN FOLLOW A PARAMETER 
VALUE 


Parameter values must be 
followed by a , ) .. or space. 


Replace the invalid 
character following the 
parameter value with a 
valid character. 


37 


F 


THIS PARAMETER VALUE 
MUST BE A SET OR A 
RANGE 


The indicated parameter value 
cannot be a single value; the 
value must be a set of values 
or a range of values . 


Replace the indicated 
parameter value with a 
valid set or range of 
values . 
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TABLE B-l. SORT /MERGE DIAGNOSTICS (Contd) 



Error 
Number 


Error 
Level 


Message 


Significance 


Action 


50 


W 


DIALOG PARAMETER CAN 
ONLY BE SPECIFIED IN A 
CONTROL STATEMENT 


The DIALOG parameter cannot be 
In a directive file. 


Specify the DIALOG parame- 
ter in a control statement. 


51 


F 


ONLY 3 VALUES CAN BE 
GIVEN IN KEY/SUM VALUE- 
SET IF F..L FORMAT IS 
USED 


Values in a KEY or SUM parame- 
ter value-set are separated by 
commas or spaces. If you use 
the fir st.. last form to specify 
key or sum field position and 
length, a maximum of two other 
values (separated by commas or 
spaces) is allowed. 


Correct the KEY or SUM 
parameter so that no more 
than three values are 
specified. 


52 


F 


FILE, PROC AND COL-SEQ 
NAMES MUST BEGIN WITH A 
LETTER 


A letter (A-Z) must be the 
first character in a file name, 
procedure name, or the name of 
a collating sequence you have 
defined. 


Begin each file name, pro- 
cedure name, and collating 
sequence name with a 
letter. 


53 


F 


VALUES ALLOWED FOR THE 
FASTIO PARAMETER ARE 
YES AND NO 


Valid values for the FASTIO 
parameter are YES or NO, which 
can be specified as Y or N. 


Specify a valid value for 
the FASTIO parameter. 


54 


W 


MORE THAN 100 INPUT 
FILES GIVEN, ONLY THE 
FIRST 100 SORTED 


No more than 100 files can be 
sorted in any one job step; 
files specified in excess of 
100 are ignored. 


The files in excess of 100 
can be sorted in a separate 
job step. 


56 


F 


IF THE FIRST VALUE OF A 
SEQS IS A RANGE THEN 
ALL OTHER VALUES OF 
THAT SEQS MUST BE 
RANGES OF THE SAME 
LENGTH 


Single characters cannot follow 
a range of characters In a SEQS 
parameter. 


Correct the SEQS parameter 
so that it consists of 
ranges of characters with 
the same number of charac- 
ters in each range. 


57 


F 


WHEN LOW.. HIGH IS USED 
AS A VALUE FOR SEQS LOW 
MUST BE LESS THAN HIGH 


If a range of characters is 
used in a SEQS parameter, the 
first character in the range 
must be of less value than the 
last. 


Correct the SEQS parameter 
so that the first character 
in the range is less than 
the last. 


58 


F 


ONLY SINGLE CHARACTER 
STRINGS OR $CHAR CAN BE 
USED AS VALUES FOR SEQS 


Each character specified in a 
SEQS parameter must be enclosed 
in apostrophes and separated 
from other characters by .. or 
a comma; characters cannot be 
grouped together. $CHAR(n) 
must specify a single charac- 
ter. 


Correct the SEQS parameter. 


59 


F 


FOR $CHAR(N), N MUST BE 
A POSITIVE DECIMAL 
INTEGER 


If $CHAR(n) is used in a SEQS 
parameter to specify a value 
step consisting of one charac- 
ter, n must be a positive deci- 
mal integer that corresponds to 
the number of the intended 
character in your character 
set. 


Specify n as a positive 
decimal integer. 


60 


F 


CONTRADICTORY VALUES 
FOR LO PARAMETER SHOULD 
NOT BE SPECIFIED 


You cannot specify LO=OFF along 
with S and/or A. 


Correct the LO parameter. 


61 


F 


FILE NAMES MUST NOT 
EXCEED 7 CHARACTERS IN 
LENGTH 


A file name can be no longer 
than 7 characters. 


Change the name of the file 
to a name that is 7 charac- 
ters or fewer in length. 
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TABLE B-l. SORT/MERGE DIAGNOSTICS (Contd) 



Error 
Number 


Error 
Level 


Message 


Significance 


Action 


62 


C 


THE MAXIMUM LENGTH OF A 
LINE IS 240 CHARACTERS 


The S0RT5 or MERGE control 
statement and its associated 
parameter list can be no longer 
than 240 characters (periods 
used as continuation indicators 
are not counted). 


Parameters can be placed in 
a directive file so that 
the control statement is 
240 characters or less. 


63 


F 


VALUES ALLOWED FOR THE 
DIALOG PARAMETER ARE 
YES AND NO 


Valid values for the DIALOG 
parameter are YES or NO, which 
can be specified as Y or N. 


Specify a valid value for 
the DIALOG parameter. 


64 


F 


A SPACE OR , MUST 
FOLLOW THE SORT OR 
MERGE VERBS IN DIR. 
FILES 


In a directive file, any state- 
ment that begins with SORT or 
with MERGE must have a space or 
a comma immediately following 
SORT or MERGE. 


Insert a space or a comma 
immediately following SORT 
or MERGE in your directive 
file. 


65 


C 


A PERIOD MUST FOLLOW 
SORT5 OR MERGE 


In a control statement, the 
word SORT5 or the word MERGE 
must be immediately followed by 
a period. 


Insert a period immediately 
following the word S0RT5 or 
the word MERGE. 


67 


F 


ALL DIRECTIVE FILE 
NAMES MUST BE UNIQUE 


A directive file cannot have 
the same name as any other 
directive file used in the sort 
or merge. 


Give all directive files 
different names. 


68 


F 


LINES CONTINUING THE 
S0RT5 OR MERGE 
PARAMETER-LIST MUST 
BEGIN WITH A PERIOD 


Any line of a S0RT5 or a MERGE 
control statement that is con- 
tinued beyond the first line 
must begin with one period. 


Begin each continuation 
line with one period. 


69 


F 


FILE NAMES CAN CONTAIN 
ONLY LETTERS AND DIGITS 


A file name cannot contain any 
special characters. 


Omit special characters 
from the file name. 


70 


F 


LENGTH MUST BE 
SPECIFIED IF TYPE IS 
SPECIFIED 


If the key type is other than 
the default ASCII6, or if 
ASCII6 is explicitly specified, 
key' length cannot be omitted. 


Specify key length. 


71 


F 


KEY LENGTH FOR KEY OF 
KEYTYPE REAL MUST BE 10 


Keys declared to be of type 
REAL must occupy a full compu- 
ter word and must be specified 
as 10 bytes in length. 


Specify length of REAL key 
as 10. 


72 


F 


ONLY THE VALUES A OR D 
ARE ALLOWED FOR KEY 
ORDER 


Sort order can be specified as 
ascending with A or as descend- 
ing with D. 


Specify either A or D for 
sort order; or omit speci- 
fication of sort order and 
ascending is assumed. 


73 


W 


UNEQUAL FL FOR INPUT 
AND OUTPUT FILES WITH 
RT=F OR RT-Z 


If you specify different fixed 
length for input and output 
files, Sort/Merge compresses or 
expands records to fit into the 
fixed length. 


For the most efficient pro- 
cessing, specify the same 
FL for input and output 
files. 


74 


F 


VALUES ALLOWED FOR THE 
EL PARAMETER ARE T, W, 
F OR C 


The only values that can be 
specified for the EL parameter 
are T, W, F, or C. 


Specify T, W, F, or C as 
the value of the EL 
parameter. 


75 


F 


VALUES ALLOWED FOR THE 
LO PARAMETER ARE OFF, S 
AND A 


The only values that can be 
specified for the LO parameter 
are OFF, S, or A. 


Specify OFF, S, or A as the 
value of the LO parameter. 
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TABLE B-l. SORT/MERfiE DIAGNOSTICS (Contd) 



Error 
Number 


Error 
Level 


Message 


Significance 


Action 


76 


F 


VALUES ALLOWED AS 
EXPRESSIONS ARE 
INTEGER, Rl, R2, R3, 
RIG, EF OR EFG 


The only values that can be 
specified as expressions are 
Integers or the CCL variables 
Rl, R2, R3, RIG, EF, or EFG. 


Specify a valid expression. 


77 


F 


$NULL SHOULD NOT BE 
USED AS A VALUE WITHIN 
A SET OF VALUES 


$NULL Is a reserved file name 
signifying a null file; it must 
not be specified in a list of 
multiple files. $NULL can be 
specified as a single value for 
a parameter. 


Delete $NULL from the list 
of files, or specify $NULL 
as the single parameter 
value . 


78 


F 


VALUES ALLOWED FOR THE 
ST PARAMETER ARE Rl, 
R2, R3, RIG, EF OR EFG 


The only values that can be 
specified for the STATUS param- 
eter are the CCL variables Rl, 
R2, R3, RIG, EF, or EFG. 


Specify a valid value for 
the STATUS parameter. 


79 


F 


VALUES ALLOWED FOR THE 
RETAIN PARAMETER ARE 
YES AND NO 


The only values that can be 
specified for the RETAIN param- 
eter are YES or NO, which can 
be abbreviated as Y or N. 


Specify a valid value for 
the RETAIN parameter. 


80 


F 


OWNMRL AND OWNFL SHOULD 
NOT BOTH BE SPECIFIED 
FOR THE SAME SORT 


In a sort with owncode rou- 
tines, record length must be 
specified with either the 
OWNMRL parameter or the OWNFL 
parameter. 


Specify record length with 
the OWNFL parameter for F 
or Z type records; specify 
record length with the 
OWNMRL parameter for all 
other record types. 


81 


F 


SUM AND KEY FIELDS MAT 
NOT OVERLAP 


The same characters in a record 
cannot be included in a sum 
field and a key field. 


Correct SUM parameter and/ 
or KEY parameter so that 
the same characters are not 
included in both field 
descriptions. 


82 


C 


LINES IN A DIRECTIVE 
FILE MUST BE NO LONGER 
THAN 100 CHARACTERS IN 
LENGTH 


A directive file statement, 
beginning with SORT or MERGE, 
can be 240 characters in 
length, but each line in the 
statement must contain no more 
than 100 characters. 


Use continuation lines in 
your directive file so that 
each line contains no more 
than 100 characters. 


83 


F 


REP. VALUE OF A SUM 
FIELD MOST BE AN 
INTEGER 


In a SUM parameter, the number 
of fields to be summed must be 
expressed as an integer value. 


Specify number of fields to 
be summed as an integer. 


84 


F 


VALUES ALLOWED FOR OWNT 
PARAMETER MUST BE OLD 
OR NEW 


The only values that can be 
specified for the OWNT param- 
eter are OLD or NEW. 


Specify OLD or NEW as the 
value for the OWNT param- 
eter. 


85 


F 


IN A KEY/ SUM VALUE-SET 
USING FIRST.. LAST, 
FIRST MUST BE LESS THAN 
LAST 


In a KEY or SUM parameter, if 
field length and position are 
specified as the first and last 
bytes or bits of the field then 
the first byte or bit must be 
less than the last byte or bit 
(the leftmost byte or bit in a 
record is counted as number 1). 


Correct the KEY or SUM 
parameter. 


86 


F 


INVALID DATA-TYPE FOR 
SUM FIELD SPECIFIED 


In a SUM parameter, sum field 
type must be the name of a num- 
eric data format except REAL; 
type cannot be a collating 
sequence. 


Correct the SUM parameter. 
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TABLE B-l. SORT/MERGE DIAGNOSTICS (Contd) 



Error 
Number 


Error 
Level 


Message 


Significance 


Action 


87 


C 


LINES OF A DIR FILE 


In a directive file, each line 


Correct the directive file; 






MUST BEGIN WITH SORT OR 


must begin with the word SORT 


determine the proper format 






MERGE VERB, OR BE A 


or MERGE or, if the line is a 


for directive files. 






CONTINUATION 


continuation line, with a char- 
acter of your parameter list or 
one or more spaces. 




88 


F 


BYTE/BIT POSITION OR 


In a SUM or KEY parameter, 


Correct the SON or KEY 






LENGTH OF A SUM/KEY 


field length and position must 


parameter. (Make sure two 






FIELD MUST BE AN 


be specified as integers, 


sets of parentheses enclose 






INTEGER 


counting the leftmost byte or 
bit in a record as number 1. 


the value-set.) 


89 


F 


SEQN VALUE MOST NOT BE 


When you are defining your own 


Give your collating 






ONE OF THE PREDEFINED 


collating sequence with SEQx 


sequence a unique name that 






KEY-TYPES 


parameters, the name of your 
collating sequence cannot be 
the same as the name of one of 
the predefined collating 
sequences . 


is not the same as one of 
the predefined collating 
sequences. 


90 


F 


SEQR AND SEQA MAY BE 


When you are defining your own 


Specify SEQR and SEQA only 






SPECIFIED ONLY ONCE FOR 


collating sequence with SEQx 


once. 






EACH COLLATING SEQUENCE 


parameters, SEQR and SEQA must 
not be specified more than 
once. 




91 


F 


SEQN MUST BE SPECIFIED 


When you are defining your own 


Specify SEQN before you 






BEFORE ANY OTHER SEQ 


collating sequence with SEQx 


specify any other SEQx 






PARAMETER CAN BE GIVEN 


parameters, the SEQN parameter 
naming your collating sequence 
must be the first SEQx 
parameter . 


parameter. 


92 


F 


VALUES ALLOWED FOR SEQR 


The only values that can be 


Specify a valid value for 






AND SEQA ARE YES AND NO 


specified for the SEQR and SEQA 
parameters are YES or NO, which 
can be abbreviated as Y or N. 


the SEQR and SEQA param- 
eters. 


93 


F 


SEQN SHOULD NOT BE 


When you are defining your own 


Correct the order of the 






GIVEN WITHOUT GIVING 


collating sequence with SEQx 


SEQx parameters. 






SEQS OR SEQR BEFORE THE 


parameters, you must specify 








NEXT SEQN 


the characters in your col- 
lating sequence with SEQS and 
SEQR parameters before naming 
another collating sequence. 




94 


F 


VALUES ALLOWED IN SEQS 


When you are defining your own 


Correct the SEQS param- 






PARAMETER ARE STRINGS 


collating sequence with SEQx 


eters. 






AND $CHAR(N) 


parameters, the only valid 
values for SEQS parameters are 
characters enclosed in apostro- 
phes or $CHAR(n) where n is the 
number of the character in your 
character set. 




95 


F 


TWO RANGES OF 


When you are defining your own 


Correct the SEQS parameter 






CHARACTERS USED IN THE 


collating sequence with SEQx 


so that it specifies ranges 






SAME SEQS MOST BE THE 


parameters, the ranges in any 


that are all the same 






SAME LENGTH 


one SEQS parameter must all be 
the same length. 


length. 
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TABLE B-l. SORT/MERGE DIAGNOSTICS (Contd) 



Error 
Number 



Error 
Level 



Message 



Significance 



Action 



96 



97 



98 



99 



100 



101 



102 



103 



104 



107 



108 



110 



111 



VALUE GIVEN IN THE 
$CHAR FUNCTION MUST BE 
AN INTEGER 



CHARACTERS GIVEN IN A 
SINGLE COLLATING 
SEQUENCE MUST APPEAR 
ONLY ONCE 



COL-SEQUENCE NAMES 
LONGER THAN 10 
CHARACTERS ARE 
TRUNCATED 



NUMBER OF KEY AND SUM 
CHARACTERS MUST BE NO 
MORE THAN 255 

SIGNED NUMERIC CHARAC- 
TER FIELD IS TOO SHORT 



NO PARAMETER CAN BE 
SPECIFIED MORE THAN 
ONCE ON A LINE 

DUPLICATE PARAMETER 
SPECIFIED 

EITHER AN INPUT FILE, 
0WN1 OR OWN2 MUST BE 
GIVEN 

EITHER AN OUTPUT FILE, 
OWN3 OR 0WN4 MUST BE 
GIVEN 

INCORRECT PARAMETER 
VALUE 



TOO FEW/MANY PARAMETERS 



CALL OUT OF SEQUENCE 



INVALID NAME GIVEN FOR 
SM5SEQN 



When you are defining your own 
collating sequence with SEQx 
parameters and are using 
$CHAR(n) to specify the charac- 
ters in the sequence, n must be 
a decimal integer corresponding 
to the number of the intended 
character in your character set. 

When you are defining your own 
collating sequence with SEQx 
parameters, a character cannot 
appear more than once in all 
the SEQS parameters. 

You can specify a collating 
sequence name of up to 31 char- 
acters in length, but only the 
first 10 characters are sig- 
nificant. 

A record cannot contain more 
than 255 characters that are 
defined as key or sum fields. 

A key field defined by a KEY 
parameter or SM5KEY call as 
one of the signed numeric data 
formats is not long enough to 
contain the data. 

Parameters that can be specified 
more than once must be on separ- 
ate lines. 

Some parameters can only be 
specified once. 

No sort input file given. 



No sort output file given. 



A value specified as a proce- 
dure call parameter is not a 
valid value. 

Either too few or too many 
parameters have been specified 
in a procedure call. 

A call to a Sort/Merge FORTRAN 
procedure Is not in the proper 
order . 

The name of a user-defined col- 
lating sequence specified with 
the SM5SEQN call must begin 
with a letter and consist of 
letters, digits, and the 
special characters ? # @ 



Specify n of $CHAR(n) as a 
decimal integer. 



Specify each character only 
once in a collating 
sequence . 



None. 



Specify the total number 
of key and sum characters 
together as 255 or less. 

Redefine the key field as 

long enough to contain all 

the numeric characters and 
the sign. 



Inspect parameters and 
correct error(s). 



Inspect parameters and 
correct error ( s ) . 

Specify a sort input file, 
or 0WN1 or 0WN2. 



Specify a sort output file, 
or 0WN1 or 0WN2. 



Check values that can be 
specified for the procedure 
call parameter. 

Determine parameters that 
can be specified in the 
procedure call. 

Determine procedure call 
order . 



Correct the name specified 

with the SM5SEQN call; 

enclose the name in apos- 
trophes. 
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TABLE B-l. SORT/MERGE DIAGNOSTICS (Contd) 



Error 
Number 


Error 
Level 


Message 


Significance 


Action 


112 


F 


ONLY SINGLE CHARACTER 
LITERALS CAN BE USED AS 
PARAMETERS OF SM5SEQS 


Each character in a user- 
defined collating sequence 
specified as parameters of 
the SM5SEQS procedure must be 
specified separately, enclosed 
in apostrophes, and separated 
from other characters by 
commas* 


Specify each character in 
your collating sequence as 
a separate literal enclosed 
in apostrophes. 


113 


A 


RECORD LENGTH IS 
GREATER THAN MAXIMUM 
RL - 5000 


Record length is set by the full 
length (FL) or maximum record 
length (MRL) file information 
table (FIT). Also, the OWNFL 
and OWNMRL parameters or SM50FL 
and SM50MRL procedures specify 
the length of a record. Re- 
cord length cannot exceed 5000 
characters. 


Create a new file with 
record length of 5000 
characters or less. 


114 


F 


SUM FIELDS MAY NOT BE 
GREATER THAN 60 BITS 


Summing is handled with integer 
arithmetic. Integer and binary 
sum fields can be no more than 
60 bits long. 


Correct the specification 
of the sum field. 


115 


C 


RETAIN AND SUMMING MAY 
NOT BE SPECIFIED AT THE 
SAME TIME 


You cannot specify both the 
RETAIN and the SUM parameter in 
the same sort or merge. 


Remove the RETAIN or SUM 
parameter. 


116 


W 


MRL/FL IS NOT LARGE 
ENOUGH TO ACCOMMODATE 
THE SPECIFIED KEYS 


The record size (MRL or FL) is 
not large enough to accommodate 
the specified keys. 


Change your key or file 
description. 


117 


W 


FASTIO PARAMETER 
DISABLED FOR FILES NOT 
ON MASS STORAGE 


The FASTIO parameter cannot 
process tapes. 


None necessary. 


118 


w 


FASTIO PARAMETER 

WAS SPECIFIED BUT COULD 

NOT BE PROCESSED 


FASTIO files must have the 
same record type and length, 
and must reside on mass 
storage. 


Recheck file 
specifications . 


151 


w 


NOT SORT, MERGE OR 
OUTPUT; SORT ASSUMED 


In the SMFILE call, file dis- 
position must be indicated as 
SORT, MERGE, or OUTPUT. 


None, or change SMFILE call 
to indicate MERGE or OUTPUT. 


152 


c 


RETURNED FROM OWNCODE 
WITHOUT CALLING SMRTN 


Control has returned to Sort/ 
Merge from an owncode routine 
without using a call to SMRTN; 
processing terminates. 


Determine the proper method 
of calling SMRTN. 


153 


c 


EXCESSIVE NUMBER OF 
ERRORS FOUND (n). 
PROCESSING TERMINATED. 


The maximum number of errors 
for one call to Sort/Merge have 
occurred; processing terminates. 


Correct errors and resubmit 
job. 


154 


F 


SMRTN CANNOT BE USED 
WHEN USING SM5 PROCE- 
DURES 


The Sort/Merge 4 compatible 
routine SMRTN has been called 
by a set of owncode procedures 
using SM5xxx calls. 


Change SMRTN to RETURN or 
the equivalent. 


155 


C 


RETURN CODE MUST BE IN 
RANGE 0-3 


The return code from all own- 
code routines must be 0, 1, 2, 
or 3. 


Change the value of the 
return code. 
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GLOSSARY 



This glossary defines terms unique to the descrip- 
tion of Sort/Merge; common terms that have special 
connotations within the context of this manual are 
also Included. 



determine the status of files, Initiate tests 
and transfers within the control statement 
section, and display results In your job 
dayfile. 



Ascending - 

The order of sorting keys so that the record 
having the numeric key with the highest value 
Is written last on the output file, and charac- 
ter keys are sorted according to the specified 
collating sequence. See Sort Order. 

ASCII - 

American National Standard Code for Information 
Interchange. An 8-bit code representing a 
prescribed set of 128 characters. Control Data 
operating systems use a 6-bit display code to 
represent a subset (called ASCII6) of these 
characters . 

Basic Access Methods (BAH) - 

- A file manager that processes sequential and 
word addressable file organizations. See CYBER 
Record Manager. 

Beginning-of-Information (BOI) - 

The start of your first record in a file. 
System information, such as tape labels of 
sequential files, can appear before beginning- 
of-inf ormation . 

Block - 

A logical or physical grouping of records. 
CYBER Record Manager defines block types I, C, 
K, and E for sequential files. 

Byte - 

A group of bits. In the body of this manual, a 
byte is six bits that represents a single 
character. 

Character - 

A letter, digit, punctuation mark, or mathe- 
matical symbol forming part of one or more of 
the standard character sets. 

Collating Sequence - 

A sequence in which the characters that are 
acceptable to a computer are ordered for 
purposes of sorting, merging, and comparing. 

Control Statement Section - 

The first section of a job; contains the 
sequence of control statements that specifies 
all steps for job execution. 

Control Statement Sort - 

A sort performed on the basis of parameters in 
the S0RT5 control statement and in optional 
directive files. 

CYBER Control Language (CCL) - 

A language that allows you to insert a set of 
statements into the control statement section 
of your job; provides a means for you to 



CYBER Record Manager (CRM) - 

A generic term relating to the common products 
Advanced Access Methods and Basic Access 
Methods that run under the NOS and NOS/BE 
operating systems and that allow a variety of 
record types, blocking types, and file 
organizations to be created and processed. The 
execution time input/ output of COBOL, FORTRAN, 
Sort/ Merge, ALGOL, and the DMS-170 products is 
implemented through CYBER Record Manager. The 
input/output of the NOS and NOS/BE operating 
system utilities such as COPY or SKIPF are not 
implemented through CYBER Record Manager. All 
CYBER Record Manager file processing requests 
ultimately pass through the operating system 
input/output routines. 

Default - 

A value supplied by Sort/Merge when you omit a 
specification from a parameter list. 

Descending - 

The order of sorting keys so that the record 
having the numeric key with the lowest value is 
written last on the output file, and character 
keys are sorted in reverse order of the speci- 
fied collating sequence. See Sort Order. 

Dialog - 

An interactive aid designed to guide an in- 
experienced user through a sort or merge 
specification. 

Directive File - 

A file that can be used In a control statement 
sort or merge; contains processing parameters 
in addition to the parameters specified in the 
S0RT5 or MERGE control statement. This file 
must be a sequential file of block type C and 
record type Z. 

Display Code - 

A 6-bit code representing a 63-character or 
64-character computer character set. 

EBCDIC - 

The abbreviation for extended binary-coded 
decimal interchange code. Control Data oper- 
ating systems use a 6-bit version (called 
EBCDIC6) to represent this code. 

End-of- Information (EOI) - 

CYBER Record Manager defines end-of-information 
in sequential files in terms of the file resi- 
dence, as shown in table C-l. 

Entry Point - 

A location within a program that can be refer- 
enced from other programs. Each entry point 
has a unique name with which it is associated. 
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TABLE C-l. END-OF-INFORMATION BOUNDARIES 



File 
Organization 


File 
Residence 


Physical 
Position 


Sequential 
Sequential 

Sequential 

Sequential 


Mass storage 

Labeled tape 
in SI, I, S, 
or L format 

Unlabeled 
tape in SI 
or 1 format 

Unlabeled 
tape iii S or 
L format 


After the last 
user record. 

After the last 
user record and 
before any file 
trailer labels. 

After the last 
User record and 
before any file 
trailer labels. 

Undefined. 



File - 

A collection of records treated as a unit; 
represented by a logical file name and delim- 
ited by beginning-of-informatlon and end-6f- 
infomation. 

FILE Control Statement - 

A control statement that supplies file informa- 
tion table (FIT) Values after a source language 
program is compiled or assembled but before the 
program is executed; Basic file characteris- 
tics such as organization, record type, and 
description can be specified in the FILE 
control statement . 

File Information Table (FIT) - 

A table through Which your program communicates 
with BAM. All file processing executes Oh the 
basis of information in the Fits tou can set 
FIT fields directly or use parameters in a file 
access call that sets the fields indirectly. 

Floating-Point Number - 

Numeric data stored internally aS binary 
values (corresponds to a FORTRAN REAL or COBOL 
COMPUTATIONAL- 2 number). 



Graphic - 

A character that can be printed or displayed; 



Integer - 

Numeric data stored internally as a binary 
value rather than a character value; in a 

parameter or procedure call format, a number 

that does not include any character positions 

to the right of the assumed decimal point and 
is not signed. 

Interactive - 

Job processing in Which you and the system 
communciate with each other, rather than your 
submitting a job and receiving output, having 
no control over the job while processing occurs. 



Interactive Facility (IAF) - 

The network host software product that allows 
you to enter commands and to communicate with 
an executing program from a time-sharing 
terminal; operates under NOS. 

INTERCOM - 

The software that directs the flow of informa- 
tion and data between the central site computer 
and a number of remote terminals; operates 
under NOS/BE. 

Job - 

A set of control statements and the data and 
directives used by those control statements. A 
batch job begins with the job, USER, and CHARGE 
statements on NOS and the job and ACCOUNT 
statements on NOS/BE. An interactive job 
begins with login to a terminal. 

Key Type - 

The name of a numeric data format or collating 
sequence. 

Keyword - 

A part of a parameter that you enter exactly as 
shown in the parameter format. It is not 
changed by any information you supply. 

Library - 

A collection of programs or routines that is 
searched by the loader for entry points refer- 
enced by a program. 

Literal - 

A constant completely defined by its own 
identity. 

Local File - 

A file currently assigned to a job, or a 
temporary file other than the primary file; 
often contains a copy of an indirect access 
file or data from a magnetic tape. 

Logical File Name (Ifn) - 

the one to seven coded letters or digits by 
which the operating system recognizes a file; 
Every iogical file name in a job must be unique 
and begin with a letter; 

Logical Record - 

Under NOS, a data grouping that consists of one 
or more PRUs terminated by a short PRO or 
zero-length PRU. Equivalent to a system- 
logical-record under NOS/BE; 

Login - 

The process used at a terminal to gain access 
to the system. 

Logout - 

The process used to end a terminal session. 

Major Sort Key - 

A sort key that is considered to be the most 
important and is specified first. See Sort 
Key, Minor Sort Key. 

Mass Storage - 

A disk pack or other rotating mass storage 
device; not a magnetic tape. 
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Merge - 

The process of combining two or more presorted 
files. 

Minor Sort Key - 

A sort key that is considered of lesser impor- 
tance and is specified after the most important 
sort key. See Sort Key, Major Sort Key. 

Owncode Routine - 

A subroutine you write that provides the capa- 
bility of inserting, substituting, modifying, 
or deleting input and output records during 
Sort/Merge processing. 

Parameter - 

A variable identified by a keyword and assigned 
specific values in the S0RT5 or MERGE control 
statement or in a directive file; parameters 
and their specified values direct Sort/Merge 
processing. 

Partition - 

CYBER Record Manager defines a partition as a 
division within a file with sequential orga- 
nization. Generally, a partition contains 
several records or sections. Implementation 
of a partition boundary is affected by file 
structure and residence, as shown in table C-2. 

Notice that in a file with W type records, a 
short physical record unit (PRU) of level 
terminates both a section and a partition. 

Physical Record Unit (PRH) - 

Under NOS and NOS/BE, the amount of information 
transmitted by a single physical operation of a 
specified device. The size of a PRU depends on 
the device, as shown in table C-3. 

A PRU that is not full of user data is called a 
short PRU; a PRU that has a level terminator 
but no user data is called a zero-length PRU. 

Procedure - 

A subroutine that returns values through its 
parameters; invoked when the name of the 
procedure is referenced in a CALL or ENTER 
statement. 

Record - 

CYBER Record Manager defines a record as a 
group of related characters. A record or a 
portion thereof is the smallest collection of 
information that can be passed between CRM and 
your program. Eight different record types 
exist, as defined by the RT field of the file 
information table. 

Record Type - 

The term record type can have one of several 
meanings, depending on the context. CYBER 
Record Manager defines eight record types 
established by an RT field in the file infor- 
mation table. Tables output by the loader 
are classified as record types such as text, 
relocatable, or absolute, depending on the 
first few words of the tables. 

Relocatable - 

An object program that can reside in any part 
of central memory. The actual starting address 
is established at load time. 



TABLE C-2. PARTITION BOUNDARIES 





Record 


Block 




Device 


Type 


Type 


Physical Boundary 




(RT) 


(BT) 




PRU 


W 


I 


A short PRU of 


device 






level containing 
a one-word deleted 
record pointing 
back to the last I 
block boundary, 
followed by a con- 
trol word with a 
flag indicating a 
partition boundary. 




w 


C 


A short PRU of 
level containing 
a control word 
with a flag indi- 
cating a partition 
boundary. 




D.F.R, 


C 


A short PRU of 




T.U.Z 




level followed by 
a zero-length PRU 
of level 17g. 




S 


- 


A zero-length PRU 
of level number 17g. 


S or L 


W 


I 


A separate tape 


format 






block containing as 


tape 






many deleted rec- 
ords of record 
length as re- 
quired to exceed 
noise record size, 
followed by a de- 
leted one-word 
record pointing 
back to the last I 
block boundary, 
followed by a con- 
trol word with a 
flag indicating a 
partition boundary. 




w 


c 


A separate tape 
block containing as 
many deleted rec- 
ords of record 
length as re- 
quired to exceed 
noise record size, 
followed by a con- 
trol word with a 
flag indicating a 
partition boundary. 




D.F.T, 


C.K.E 


A tapemark. 




R.U.Z 








S 


- 


A tapemark. 


Any 


_ 


- 


Undefined . 


other 








tape 








format 









60484800 B 



C-3 



TABLE C-3. PRU SIZES 



TABLE C-4. SECTION BOUNDARIES 



Device 


Size in Number 
of 60-Bit Words 


Mass storage. 

Tape in SI format with 
binary data (NOS/BE only). 

Tape in I format (NOS only). 

Tape in any other format. 


64 
512 

512 
Undefined. 



Result Array - 

A means of passing statistics and results of a 
sort or merge back to a calling procedure. 

Rewind - 

An operation that positions a file at the 
beg inning-of - inf orma t i on . 



Section - 

CYBER Record Manager defines a Election as a 
division within a file with sequential orga- 
nization. Generally, a section contains more 
than one record and is a division within a 
partition of a file. A section terminates 
with a physical representation of a section 
boundary, as shown in table C-4. 

The NOS and NOS/BE operating systems equate a 
section with a syatem-logical-record of level 
through 16g. 

Sequential File - 

A file with records in the physical order in 
which they were written. No logical order 
exists other than the relative physical record 
position. 

Signed Numeric Data - 

Integer data stored internally in display code; 
sorted according to numeric order and sign of 
the integer the display code represents. 

Sort Key - 

A field of information within each record in a 
sort or merge input file that is used to deter- 
mine the order in which records are written to 
the output file. 

Sort Order - 

The order for sorting keys, either ascending or 
descending. 

System-Logical-Record - 

Under NOS/BE, a data grouping that consists 
of one or more PRUs terminated by a short PRU 
or zero-length PRO. These records can be 
transferred between devices without loss of 
structure. Equivalent to a logical record 
under NOS. 



Word 



A group of bits (or 6-bit characters) between 
boundaries imposed by the computer system. A 
word is 60 bits in length (10 characters). 





Record 


Block 




Device 


Type 
(RT) 


Type 
(BT) 


Physical 
Representat ion 


PRU 


W 


I 


A deleted one-word 


device 






record pointing 
back to the last I 
block boundary 
followed by a con- 
trol word with 
flags indicating a 
section boundary. 
At least the con- 
trol word is in 
a short PRU of 
level 0. 




W 


C 


A control word with 
flags indicating a 
section boundary. 
The control word 
is in a short PRU 
of level 0. 




D.F.R, 


c 


A short PRU with a 




T,U,Z 




level less than 




S 


- 


Undefined. 


S or L 


W 


I 


A separate tape 


format 






block containing 


tape 






as many deleted 
records of record 
length as re- 
quired to exceed 
noise record size, 
followed by a de- 
leted one-word 
record pointing 
back to the last I 
bloek boundary, 
followed by a con- 
trol word with 
flags indicating a 
section boundary. 




W 


c 


A separate tape 
block containing 
as many deleted 
records of record 
length as re- 
quired to exceed 
noise record size, 
followed by a con- 
trol word with 
flags indicating a 
section boundary. 




D.F.R, 


C.K.E 


Undefined. 




T,U,Z 








S 


- 


Undefined. 


Any 


- 


- 


Undefined. 


other 








tape 








format 
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SORT/MERGE PARAMETER SUMMARY 



The format specifications for all parameters used 
in a S0RT5 or a MERGE control statement are sum- 
marized and listed in this appendix. Detailed 
information for each parameter is referenced by 
page number and appears in section 3 of this manual. 

The following abbreviations are used in this 
appendix: 



char 


character 


expr 


expression 


lfn 


logical file name 


proc 


procedure name 


rep 


repetition 



DIALOG Parameter 

DIALOG=YES (or DIA=Y) 
DIALOG=NO (or DIA=N) 



Page 
3-4 



FROM Parameter 
FROM=lfn 

FROM=(lfn 1 ,lfn 2> ...) 
FROM=$NULL 

KEY Parameter 



KEY= r(key_def[,key_def] 
|_ range 

where : 



...)] 



Page 
3-2 



3-2 



Trange 
key_def= (range [.type t.ad]]) 

L(first, length [,type [,ad]]). 

range = ["first "1 
[.first.. last J 



DIR Parameter 
DIR=lfn 
DIR=(lfn 1 ,lfn 2 ,...) 



3-3 



L Parameter 
L-lfn 
L=$NULL 



3-3 



E Parameter 
E=lfn 

E=$NULL 

EL Parameter 
EL=T 
EL=* 
EL=F 
EL=C 

ENR Parameter 
ENR=expr 
ENR=expr . . expr 



3-4 



3-4 



3-4 



OWNF Parameter 
OWNF=lfn 

OWNFL Parameter 
OWNFL=integer 
OFL=integer 

OWHMRL Parameter 
OWNMRL=integer 
OMRL=integer 

OWNn Parameter 
0WNn=proc 



3-4 



3-5 



3-5 



3-5 



FASTIO Parameter 

FASTIO=YES (or FASTIO=Y) 
FASTIO=NO (or FASTIO=N) 



3-9 RETAIN Parameter 

EETAIN=YES (or RET=Y) 
BETAIN=NO (or RET=N) 



3-5 
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SEQx Parameters 

SEQN=name 

SEQS=('char' 'char') 



Page 
3-5 



Page 



where : 



sum_def= Rfirst, length, type [, rep] )"| 
L(first.. last, type[, rep]) J 



[SEQR=YES OR SEQR=Y] 
[SEQA-YES OR SEQA=Y] 



| STATUS Parameter 

STATUS=varlahle (or ST=variable) 

SUM Parameter 
| SXJM=((sum_def)[,(sMm_def )]...) 



3-7 



3-8 



TO Parameter 
TO=lfn 
TO=$NULL 

VERIFY Parameter 

VERIFY=YES (or VER=Y) 
VERIFY=NO (or VER=N) 



3-2 



3-9 
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INTERACTIVE DIALOG 



This appendix contains the text of the interactive "next" or a number following an answer indicates 

dialog (figure E-l) that is invoked when you spec- the next question that is asked by Sort/Merge. For 

ify DIALOGUES. The questions asked by Sort/Merge questions requiring yes or no answers, you can 

are indicated by uppercase letters. The answers abbreviate and use y or n. 



you supply are indicated by- lowercase letters; 



ARE YOU SURE THAT ALL YOUR FILES (IF ANY) ARE EITHER STANDARD UNIT RECORD FORMAT OR HAVE HAD FILE 
CONTROL STATEMENTS SPECIFIED FOR THEM? 
yes (1) 
no (next) 

UNLESS YOU SPECIFY OTHERWISE, ALL INPUT FILES AND THE OUTPUT FILE ARE ASSUMED TO HAVE STANDARD UNIT 
RECORD FORMAT SUCH AS LINES TYPED FROM A TERMINAL, LINES IN A BATCH JOB, OR LINES TO BE PRINTED ON A 
PRINTER OR TERMINAL. THESE ARE TECHNICALLY KNOWN AS BT=C, RT=Z, FL=N WITH N NO MORE THAN 150. DO YOU 
HAVE ANY FILES THAT ARE NOT OF THIS FORMAT? 
yes (next) 
no (1) 

FOR EACH FILE THAT IS NOT OF THIS FORMAT YOU MUST HAVE SPECIFIED A FILE CONTROL STATEMENT. SORT/MERGE 
WILL QUIT NOW SO YOU MAY DO SO. 

1. DO YOU HAVE JUST ONE INPUT FILE AND NO 0WN1 OR 0WN2 SUBROUTINES? 
yes (next) 

no (6) 

2. WHAT IS THE NAME OF YOUR INPUT FILE? 
f i le-name 

3. DO YOU HAVE ANY 0WN3 OR OWN4 SUBROUTINES? 
yes (9) 

no (next) 

4. WHAT IS THE NAME OF YOUR OUTPUT FILE? 
f 1 le-nane 

5. THE STANDARD COLLATING SEQUENCE IS ASCII6. HERE IS THE WHOLE ASCII6 COLLATING SEQUENCE LISTED 

!"#$X8' ()*+,-. /0123456789:;<=>?aABCDEFGHIJKLHN0PQRSTUVWXYZi:\3<*> 
DO ALL OF YOUR KEYS CONSIST OF CHARACTER DATA TO BE SORTED ACCORDING TO THE ASCII6 COLLATING 
SEQUENCE? 
yes (next) 
no (12) 

ASCENDING ORDER OF THE ASCII6 COLLATING SEQUENCE MEANS THE NORMAL ORDER. 

!"#$X&' ()*+,-. /0123456789:;<=>?aABCDEFGHIJKLMN0PQRSTUVWXYZC\]*_ 
DESCENDING ORDER MEANS THE REVERSE ORDER. 

*0\CZYXWVUTSRQPONNLKJ IHGFEDCBA8?>=<; :9876543210/.-,+*) CMS*" ! 
ISO YOU WANT ALL YOUR KEYS SORTED IN ASCENDING ORDER? 
yes (next) 
no (next) 

33. HOW MANY KEY FIELDS DO YOU HAVE? 
number 

WHAT IS THE TYPE OF THE MOST IMPORTANT KEY FIELD? 
key-type 

THE LEFT-MOST CHARACTER OF A RECORD IS NUMBER 1. FOR THE MOST IMPORTANT KEY FIELD, WHAT IS THE 

NUMBER OF THE LEFT-MOST CHARACTER? 

number 

HOW MANY CHARACTERS ARE IN THE MOST IMPORTANT KEY FIELD? 
number 



Figure E-1. Interactive Dialog (Sheet 1 of 5) 
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DO YOU WANT THIS KEY FIELD SORTED IN ASCENDING ORDER?' 
yes (next) 
no (next) 

FOR THE SECONDttnoST IMPORTANT KEY FIELD, WHAT IS THE TYPE OF THE KEY? 
key-type 

FOR THE SECOND** MOST IMPORTANT KEY FIELD, WHAT IS THE NUMBER OF THE LEFT-MOST CHARACTER? 
number 

HOW MANY CHARACTERS ARE IN THE SECOND**MOST IMPORTANT KEY FIELD? 
number 

DO YOU WANT RECORDS WITH EQUIVALENT KEY VALUES TO BE WRITTEN IN THE SAME ORDER THEY ARE READ? 
yes (next) 
no (next) 

A SUM FIELD IS A SPECIAL FIELD IN A RECORD THAT IS CHANGED BY SORT/MERGE. IF SUM FIELDS ARE 
SPECIFIED SUN FIELDS FROM RECORDS WITH EQUAL KEY VALUES WILL BE NUMERICALLY SUMMED AND PUT IN THE 
SAME SUM FIELD IN A NEW RECORD. THE REMAINING KEY AND DATA FIELDS IN THE NEW RECORD WILL BE SET TO 
THE CORRESPONDING FIELDS IN ONE OF THE OLD RECORDS. THE ORIGINAL RECORDS WILL BE DELETED. RECORDS 
HAY HAVE MORE THAN ONE SUM FIELD, AND THEY WILL BE SORTED ACCORDING TO KEY VALUES. THEY TYPE OF A 
SUM MAY BE ANY NUMERIC KEY TYPE EXCEPT REAL, 

28. HOW MANY SUM FIELDS DO YOU HAVE? 

number 

WHAT IS THE TYPE OF THE FIRST** SUM. FIELD? 
sum-type 

WHAT IS THE FIRST CHARACTER IN THE FIRST**SUM FIELD? 
number 

HOW MANY CHARACTERS* LONG IS THE FIRST** SUH FIELD? 
number 

GIVE AN ESTIMATE Of THE MAXIMUM NUMBER OF RECORDS TO BE SORTED, 
number (end of dialog) 

6. DO YOU HAVE AN OWN1 SUBROUTINE? 
yes (next) 

no (7) 

WHAT IS THE NAME QF THE FILE CONTAINING YOUR OWNCODE SUBROUTINE (S)? 
f i Le-name 

WHAT IS THE NAME OF YOUR QWN1 SUBROUTINE? 
entry-name 

7. DO YOU HAVE AN OWN? SUBROUTINE? 
yes (next) 

no (8) 

WHAT IS THE NAME QF THE FILE CONTAINING YQUR OWNCODE SUBROUTINE(S)?** 
f i le-name 

8. HOW MANY INPUT FILES DO YOU HAVE? 
1 (2) 

number (next) 

WHAT IS THE NAME OF YOUR FIRST*? INPUT FILE? 
f i le-name 

9. WHAT IS THE NAME QF THE FILE CONTAINING YOUR OWNCODE SUBROUTINE (S)?** 
f i le-name 

DO YOU HAVE AN OWN3 SUBROUTINE? 
yes (next) 
no (10) 

Figure E-1. Interactive Dialog (Sheet 2 of 5) 
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WHAT IS THE NAME OF YOUR 0WN3 SUBROUTINE? 
entry-na«e 

DO YOU HAVE AN 0UN4 SUBROUTINE? 
yes (next) 
no (11) 

10. WAT IS THE NAME OF YOUR 0WN4 SUBROUTINE? 
entry-naiae 

11. DO YOU HAVE AN OUTPUT FILE? 
yes (4) 

no (5) 

12. DO YOU KNOW THE NAMES OF THE KEY TYPES YOU WANT TO USE? 
yes (33) 

no (next) 

DO YOUR RECORDS CONSIST ENTIRELY OF CHARACTERS? 
yes (19) 
no (next) 

NON-CHARACTER DATA NAY BE ORDERED ACCORDING TO ITS BINARY (SIGNED OR UNSIGNED) VALUE, OR REAL (I.E. 
FLOATING POINT) VALUE. 

A SIGNED BINARY KEY INTERPRETS THE BITS WITHIN THE KEY FIELD AS A ONE'S COMPLEMENT BINARY NUMBER. 
IF THE LEFT-MOST BIT IS ZERO THEN THE NUMBER IS POSITIVE. IF THE LEFT-HOST BIT IS ONE THEN THE 
NUMBER IS NEGATIVE AND THE MAGNITUDE OF THE NUMBER IS THAT WITH ALL BITS COMPLEMENTED. IF THE KEY 
FIELD STARTS AND ENDS ON A CHARACTER BOUNDARY THEN THE KEY TYPE IS "INTEGER", OTHERWISE IT IS 
"INTEGER_BITS". 

AN UNSIGNED BINARY KEY INTERPRETS THE BITS WITHIN THE KEY FIELD AS A BINARY NUMBER. THE LEFT-MOST 
BIT IN THE FIELD CONTRIBUTES TO THE NUMERIC VALUE JUST LIKE ANY OTHER BIT IN THE FIELD. IF THE KEY 
FIELD STARTS AND ENDS ON A CHARACTER BOUNDARY THEN THE KEY TYPE IS "BINARY", OTHERWISE IT IS 
"BINARY_BITS". 

A REAL OR FLOATING POINT KEY INTERPRETS A 60-BIT VALUE AS A STANDARD FLOATING POINT NUMBER. THE KEY 
TYPE IS "REAL". 

13. IF YOU WANT MORE INFORMATION ABOUT A KEY TYPE, INCLUDING HOW TO SPECIFY IT, TYPE THE NAME OF THE KEY 
TYPE. (OTHERWISE, TYPE A SPACE.) 

binary (14) 
binary_bits (15) 
integer (16) 
integerjsits (17) 
real (18) 
A (19) 

14. A BINARY KEY FIELD IS SPECIFIED BY NAMING THE FIRST CHARACTER POSITION AND THE LENGTH OF THE FIELD. 
(THE FIRST CHARACTER POSITION IN THE RECORD IS 1.) 

(13) 

15. A BINARY_BITS KEY FIELD IS SPECIFIED BY NAMING THE FIRST BIT POSITION AND THE LENGTH OF THE FIELD. 
(THE FIRST BIT POSITION IN THE RECORD IS 1.) 

(13) 

16. AN INTEGER KEY FIELD IS SPECIFIED BY NAMING THE FIRST CHARACTER POSITION AND THE LENGTH OF THE 
FIELD. (THE FIRST CHARACTER POSITION IN THE RECORD IS 1.) 

(13) 

17. AN INTEGER_BITS KEY FIELD IS SPECIFIED BY NAMING THE FIRST BIT POSITION AND THE BIT LENGTH OF THE 
FIELD. (THE FIRST BIT POSITION IN THE RECORD IS 1.) 

(13) 

18. A REAL KEY FIELD IS SPECIFIED BY NAMING THE FIRST CHARACTER POSITION AND THE CHARACTER LENGTH OF THE 
FIELD. SINCE REAL KEY FIELDS MUST BE FULL WORDS AND ALIGNED ON WORD BOUNDARIES, THE FIRST CHARACTER 
POSITION MUST SPECIFY THE FIRST CHARACTER OF A WORD AND THE LENGTH MUST BE 10. 

(13) 
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19. KEY FIELDS CONSISTING ONLY OF CHARACTERS HAY BE ORDERED ACCORDING TO A CHARACTER COLLATING SEQUENCE 
OR ACCORDING TO A NUMERIC INTERPRETATION OF THE CHARACTERS. 

DO YOU WANT ANY OF YOUR CHARACTER KEY FIELDS TO BE INTERPRETED NUMERICALLY? 
yes (next) 
no (27) 

THE KEY TYPE FOR NUMERIC CHARACTER KEYS IS "NUMERIC XX" WHERE XX INDICATES HOW THE SIGN (IF ANY) IS 

TO BE EXTRACTED AND WHETHER LEADING BLANKS ARE ALLOWED. THE LEGAL NUMERIC CHARACTER KEY TYPES ARE: 

NUMERIC_NS ALL DIGITS, NO SIGN 

NUNERIC_FS LEADING BLANKS, THEN OPTIONAL NEGATIVE SIGN, THEN DIGITS 

NUMERICJ.S REQUIRED SIGN IS FIRST, THEN DIGITS 

NUNERIC_TS DIGITS FOLLOWED BY REQUIRED SIGN 

NUHERICJ.0 LEADING OVERPUNCHED DIGIT, THEN DIGITS 

NUMERIC_TO DIGITS FOLLOWED BY TRAILING OVERPUNCHED DIGIT 

20. IF YOU WANT MORE INFORMATION ABOUT ONE OF THE NUMERIC CHARACTER KEY TYPES, INCLUDING HOW TO SPECIFY 
IT, TYPE THE NAME OF THE KEY TYPE. (OTHERWISE, TYPE A SPACE.) 

nuner-i c_ns (21) 

nuneric_fs (22) 

numeric_ls (23) 

numeric_ts (24) 

nu»eric_lo (25) 

nuneric_to (26) 
A (27) 

21. NUMERIC_NS KEY FIELDS MUST CONTAIN ALL DECIMAL DIGIT CHARACTERS WITHOUT A SIGN. THE FIELD IS 
SPECIFIED BY NAMING THE FIRST CHARACTER POSITION AND THE CHARACTER LENGTH OF THE FIELD. 

(20) 

22. NUMERIC_FS KEY FIELDS MUST BE NUMERIC CHARACTERS IN A FLOATING SIGN FORMAT. LEADING BLANKS ARE 
REQUIRED FOR LEADING ZEROS, FOLLOWED BY AN OPTIONAL SIGN CONSISTING OF "-", FOLLOWED BY DECIMAL 
DIGIT CHARACTERS. THIS IS THE SAME FORMAT AS IS PRODUCED BY WRITING ACCORDING TO THE DEFAULT 
FORTRAN I FORMAT WITH NO MODIFIERS. THE FIELD IS SPECIFIED BY NAMING THE FIRST CHARACTER POSITION 
AND THE CHARACTER LENGTH OF THE FIELD. 

(20) 

23. THE FIRST CHARACTER OF A NUMERIC LS KEY FIELD MUST BE A "+" OR "-" CHARACTER. THE REMAINING 
POSITIONS MUST CONSIST OF DECIMAL DIGIT CHARACTERS. THE FIELD IS SPECIFIED BY NAMING THE FIRST 
CHARACTER POSITION AND THE CHARACTER LENGTH OF THE FIELD. 

(20) 

24. THE TRAILING (RIGHT-MOST) CHARACTER OF A NUMERICJS KEY FIELD MUST BE A "+" OR "-" CHARACTER. THE 
REMAINING POSITIONS MUST CONSIST OF DECIMAL DIGIT CHARACTERS. THE FIELD IS SPECIFIED BY NAMING THE 
FIRST CHARACTER POSITION AND THE CHARACTER LENGTH OF THE FIELD. 

(20) 

25. THE LEADING (LEFT-MOST) CHARACTER OF A NUMERIC LO KEY FIELD MUST BE AN OVERPUNCHED DIGIT. THE 
OVERPUNCHED DIGIT DETERMINES BOTH THE SIGN OF THE ENTIRE NUMBER AND THE VALUE OF THE LEADING DIGIT. 
CHARACTERS FROM "0" TO "9" MEAN THE SIGN IS POSITIVE AND THE LEADING DI6IT IS TO 9. CHARACTERS 
FROM "A" TO "I" MEAN THE SIGN IS POSITIVE AND THE LEADING DIGIT IS 1 to 9. CHARACTERS FROM "J" TO 
"R" MEAN THE SIGN IS NEGATIVE AND THE LEADING DIGIT IS 1 TO 9. THE CHARACTER "<" MEANS THE SIGN IS 
POSITIVE AND THE LEADING DIGIT IS 0. THE CHARACTER "!" MEANS THE SIGN IS NEGATIVE AND THE LEADING 
DIGIT IS ZERO. THE REMAINING POSITIONS OF THE FIELD MUST CONTAIN DECIMAL DIGITS. THE FIELD IS 
SPECIFIED BY NAMING THE FIRST CHARACTER POSITION AND THE CHARACTER LENGTH OF THE FIELD. 

(20) 

26. THE TRAILING (RIGHT-MOST) CHARACTER OF A NUMERIC TO KEY FIELD MUST BE AN OVERPUNCHED DIGIT. THE 
OVERPUNCHED DIGIT DETERMINES BOTH THE SIGN OF THl ENTIRE NUMBER AND THE VALUE OF THE TRAILING 
DIGIT. CHARACTERS FROM "0" TO "9" MEAN THE SIGN IS POSITIVE AND THE TRAILING DIGIT IS TO 9. 
CHARACTERS FROM "A" TO "I" MEAN THE SIGN IS POSITIVE AND THE TRAILING DI6IT IS 1 TO 9. CHARACTERS 
FROM "J" TO "R" MEAN THE SIGN IS NEGATIVE AND THE TRAILING DIGIT IS 1 TO 9. THE CHARACTER "<" MEANS 
THE SIGN IS POSITIVE AND THE LEADING DIGIT IS 0. THE CHARACTER "!" MEANS THE SIGN IS NEGATIVE AND 
THE TRAILING DIGIT IS ZERO. THE REMAINING POSITIONS OF THE FIELD MUST CONTAIN DECIMAL DI6ITS. THE 
FIELD IS SPECIFIED BY NAMING THE FIRST CHARACTER POSITION AND THE CHARACTER LENGTH OF THE FIELD. 
(20) 
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27. DO YOU WANT ANY OF YOUR CHARACTER KEYS TO BE ORDERED ACCORDING TO A COLLATING SEQUENCE? 
yes (next) 
no (32) 

THE STANDARD COLLATING SEQUENCE IS ASCII6. HERE IS THE WHOLE ASCII6 COLLATING SEQUENCE LISTED 
\"»tXi' ()*+,-. /0123456789:;<=>?aABCDEF6HIJKLHN0PQRSTUVHXYZC\]^_ 

THE KEY TYPE OF A CHARACTER KEY FIELD ORDERED ACCORDING TO A COLLATING SEQUENCE IS THE NAME OF THE 
COLLATING SEQUENCE. THE KEY FIELD IS SPECIFIED BY NAMING THE FIRST CHARACTER POSITION AND THE 
LENGTH OF THE FIELD. 

THERE ARE FIVE PRE-DEFINED COLLATING SEQUENCES: DISPLAY, C0B0L6, ASCII6, EBCDIC6 AND INTBCD. THERE 
CAN BE FROM TO 100 USER-DEFINED COLLATING SEQUENCES. 
DO YOU WANT TO DEFINE YOUR OWN COLLATING SEQUENCE? 
yes (next) 
no (32) 

29. WHEN ASKED TO TYPE IN YOUR COLLATING SEQUENCE PLEASE TYPE IT IN AS C,C,C,C,C,C OR C,C,C,C, 

C,C 
WHERE C IS A CHARACTER OR OCTAL VALUE. 

C CAN BE A LETTER, A ONE-DIGIT NUMBER OR A SPECIAL CHARACTER SUCH AS ( ) + - *. 

SORT/MERGE ASSUMES A TWO-DIGIT NUMBER IS AN OCTAL VALUE. (THE NUMBER SHOULD NOT BE FOLLOWED BY A 
LETTER "B".) THE COMMA HAS TO BE SPECIFIED BY ITS OCTAL VALUE 56. HOW MANY COLLATING SEQUENCES DO 
YOU WANT TO DEFINE? 
number 

30. WHAT IS THE NAME OF YOUR COLLATING SEQUENCE? 
sequence-name 

PLEASE TYPE IN YOUR COLLATING SEQUENCE. 

(30 if more to define) 
(next if done defining) 

DEFINING EQUATE MEANS SPECIFYING TWO OR MORE CHARACTERS ALREADY IN A COLLATING SEQUENCE AS EQUAL FOR 

COMPARISON PURPOSES. MORE THAN ONE EQUATE COLLATING SEQUENCE MAY BE SPECIFIED FOR A COLLATING 

SEQUENCE ■ 

DO YOU WANT TO DEFINE EQUATES FOR YOUR COLLATING SEQUENCES? 

yes (next) 

no (32) 

WHEN ASKED TO TYPE IN YOUR EQUATE SEQUENCE(S), PLEASE ENTER IN THE FORM C,C,C,C,C,C WHERE C IS A 
CHARACTER OR OCTAL VALUE AS EXPLAINED BEFORE. 
HOW MANY EQUATE SEQUENCES DO YOU WANT TO DEFINE? 

number 

31. WHAT IS THE NAME OF THE COLLATING SEQUENCE FOR THIS EQUATE? 
sequence-name 

PLEASE TYPE IN YOUR EQUATE SEQUENCE. 

(31 if more to define) 
(next if done defining) 

32. YOU SHOULD KNOW THE NAME(S) OF ALL KEY TYPES YOU WANT TO USE. IF YOU DO NOT KNOW, START OVER BY 
TYPING "RESTART" INSTEAD OF THE NUMBER OF KEY FIELDS. 

(33) 



'Not asked if you answered "yes" to the previous question about sort order. 
■'Repeated with successive numbers until all have been specified. 

$"BITS" if you specified sum type INTEGER_BITS or BINARY_BITS. 
*+Not asked if you gave the file name in response to question 6. 
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SORT/MERGE 5, SORT/MERGE 4 COMPARISON 



Sort/Merge 5 is functionally equivalent to Sort/ 
Merge 4, but these versions of the product are 
externally incompatible because the control state- 
ment for Sort/Merge 5 has been changed. Table F-l 
shows a comparison of Sort /Merge 5 and Sort/ 



Merge 4. As indicated in table F-l, the 
Sort/Merge 4 FORTRAN procedures can be called by 
Sort/ Merge 5 users, and the Sort/Merge 4 owncode 
exits can be taken from FORTRAN 5. 



TABLE F-l. SORT/MERGE 5, SORT /MERGE 4 COMPARISON 



Feature 


Sort/Merge 5- 


Sort/Merge 4 


Control 

Statement 

Sort 


Most sorts can be specified with the S0RT5 
control statement and parameters alone. 


A control statement sort requires a separate 
directives section of the input file. 


Merge 


Merge-only processing is available. 


Merge-only processing is available. 


Key Types 


Sort keys can be 6-bit display code charac- 
ters, signed or unsigned binary integers, 
or floating-point numbers. 


Sort keys can be 6-bit characters written in 
display code or internal BCD code, signed or 
unsigned binary integers, or floating-point 
numbers. 


Collating 
Sequences 


ASCII6 (default), C0B0L6, DISPLAY, EBCDIC6, 
and INTBCD are predefined. User-defined is 
also available. 


ASCII6 (default if installation character 
set is ASCII), C0BOL6 (default if installa- 
tion character set is CDC), DISPLAY, and 
INTBCD are predefined. User-defined is 
also available. 


Record 
Types 


Any CYBER Record Manager sequential record 
type except U can be sorted. 


Any CYBER Record Manager sequential record 
type except U can be sorted. 


Tape Sorts 


Available in a future release. 


A tape variant provides balanced and poly- 
phase tape sorting. 


Checkpoint/ 
Restart 


Not available. 


A job abnormally terminated can be captured 
on tape so that the job can be restarted 
from the checkpoint, rather than from the 
beginning. 


Interactive 
Usage 


Interactive dialog and commands are avail- 
able to aid in sort or merge specification. 


No interactive dialog or commands are 
available . 


Procedure 
Calls 


Sort or merge can be initiated from within 
a program (FORTRAN or other language) by a 
series of procedure calls. 


Sort or merge can be initiated from within 
a COMPASS or FORTRAN program by a series of 
procedure calls. The Sort/Merge 4 FORTRAN 
procedures can be called by Sort /Merge 5 
users . 


Owncode 
Routines 


Routines can be written to process input 
records, output records, or records with 
equal keys during Sort/Merge processing. 


Routines can be written to process input 
records, output records, records with equal 
keys, or nonstandard labels during Sort/ 
Merge processing. The Sort/Merge 4 FORTRAN 
owncode exits can be taken by Sort/Merge 5 
users . 


COBOL 


C0B0L5 control statement option can specify 
Sort/Merge S be used when COBOL SORT or 
MERGE statement is executed, or direct 
calls to the procedures can be made. 


The interface is through the COBOL SORT or 
MERGE statement; Sort/Merge 4 is the default 
for sorts or merges from COBOL 5. 
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INDEX 



Alter 

SEQA parameter 3-7 
SM5SEQA procedure 5-5 
Ascending (see Sort order) 
ASCII6 (see Collating sequence) 



Basic Access Methods (BAM) 3-1, 3-10, C-l 
Batch processing 1-2 
Beginning-of-information (BOI) C-l 
BINARY (see Numeric data formats) 
BBIARY_BITS (see Numeric data formats) 
Bit 2-1 

Blanks (see Spaces) 
Block 

Definition C-l 

Types 3-11 
Byte 2-1, C-l 



CALL statement 5-1 
Character 

Data 2-1 

Definition C-l 

Sets A-l 
COBOL 

Control statement 1-2, 6-1 

Sort/Merge procedures 6-1 
C0B0L6 (see Collating sequence) 
Collating sequence 

ASCII6 2-2 

C0B0L6 2-2 

Definition 1-1, 2-2, C-l 

DISPLAY 2-2 

EBCDIC6 2-2 

INTBCD 2-2 

User-defined 

SEQx parameters 3-5 
SM5SEQx procedures 5-4 
Commas 3-1, 3-9, 4-5 
Configuration 

Hardware 1-2 

Software 1-2 
Continuation lines 3-1 
Control statement (see FILE control statement, MERGE 

control statement, S0RT5 control statement) 
CYBER Control Language (CCL) 

Definition C-l 

ENR parameter 3-4 

STATUS parameter 3-7 
CYBER Record Manager (CRM) 1-1, C-l 



Data alignment 2-1 
Default 

Definition C-l 

File characteristics 1-1, 3-11 
Descending (see Sort order) 
DIA parameter (see DIALOG parameter) 
Diagnostics B-l 
Dialog (see Interactive dialog) 



DIALOG parameter 3-2, 3-4, 4-2, D-l 
DIR parameter 3-3, D-l 
Directive files 

Continuation 3-2 

Definition 1-1, C-l 

DIR parameter 3-3 

Example 8-4 

Format 3-1 

Length 3-1 

Use 1-1, 3-1, 8-4 
DISPLAY (see Collating sequence) 
Display code C-l 
Duplicate parameters 3-2 



E parameter 3-4, D-l 

EBCDIC6 (see Collating sequence) 

EL parameter 3-4, D-l 

End-of-file 3-2, 5-2 

End-of-information (EOI) C-l 

End-of -record 3-2, 5-2 

ENR parameter 3-4, D-l 

ENTER statement 6-1 

Entry point C-l 

Error 

Codes 

SM5ST procedure 5-5 
STATUS parameter 3-7 
Level 3-4, 5-3, B-l 
Messages B-l 
Status variable 

SM5ST procedure 5-5, B-l 
STATUS parameter 3-7, B-l 
Equal keys 

Owncode 5 7-4 
RETAIN parameter 3-5 
SM5RETA procedure 5-4 
Summing 

SM5SUM procedure 5-6 
SUM parameter 3-8 
Examples 

Control statement merge 8-3 
Control statement sort 
Multiple keys 8-3 
One key 8-1 
Directive file 
Creation 8-4 
Use 8-4 
Interactive commands 4-4 
Interactive dialog 8-1 
Interactive parameter specification 4-5 
NOS login 4-1 
NOS/BE login 4-2 
Output file disposition 4-4 
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